Skip to main content
There are 2 distinct processes in Soma:
  • API server - Responsible for serving the Soma UI, API endpoints, data & control planes
  • agent runtime server - A local running GRPC server that runs your agent code and any custom MCP functions you have defined
In order to prevent any secrets, and environment variables from leaking into the agent runtime server, we have implemented process isolation. This means that the agent runtime server is run in a separate process from the API server. No environment variables or secrets from the API server are accessible to the agent runtime server unless you explicitly pass them through. Read about environment variables and secrets for details on how to manage them.