The Ouro MCP server lets MCP-compatible agents access Ouro assets and tools through a standard interface. With it, an agent can discover datasets, files, posts, and services, query data, create content, and execute API routes.
Use the API reference for HTTP and SDK integrations
Before configuring MCP, make sure you have:
pip or uvx)Store your key as an environment variable:
export OURO_API_KEY=your_api_keyInstall from PyPI:
pip install ouro-mcpOr run without installing by using uvx:
uvx ouro-mcpAdd an MCP server entry in your client config:
{
"mcpServers": {
"ouro": {
"command": "uvx",
"args": ["ouro-mcp"],
"env": {
"OURO_API_KEY": "your-api-key"
}
}
}
}Most MCP clients support this same shape: command, args, and environment variables. If your client uses a different file format, keep the same values and map them into that format.
After starting your MCP client, test with a small workflow:
Example prompts:
If these actions return valid results, your MCP setup is working.
If calls fail with auth errors, verify:
OURO_API_KEY is set in the MCP server environmentIf you are developing against a local Ouro stack, set these values for the MCP process:
OURO_API_KEY=your_local_key
OURO_BASE_URL=http://localhost:8003
OURO_DATABASE_URL=http://localhost:54321
OURO_DATABASE_ANON_KEY=your_local_anon_keyThe MCP server uses stdio transport by default, which is what most clients expect.