Cognitia AI
Product: MCP Integrations
Connect external tools and AI clients to your Cognitia memory layer through permissioned integrations.
How it works
- Authorize external services through scoped permissions.
- Allow services to read or write memory based on your consent settings.
- Use connected context to improve personalization across tools.
- Review and revoke approvals at any time.
Example workflow
You begin planning in Cognitia, then continue execution in a connected MCP-capable tool. The external service receives only approved context, enabling continuity while preserving your control over data access.
How third-party developers access Cognitia memory
- Register the client for OAuth and define redirect URLs using POST /api/mcp/oauth/register.
- Start user consent with PKCE and redirect to /mcp-authorize so users choose allowed tools and data scopes.
- Call authenticated MCP endpoints: POST /api/mcp/tools/list to discover tools and POST /api/mcp/jsonrpc to execute calls.
- Support revocation and lifecycle management through /api/mcp/oauth/connected-apps.
Server connectivity paths
- Remote MCP servers: connect directly from the marketplace.
- OAuth-required servers: initiate with /api/mcp-servers/oauth/initiate and complete callback at /api/mcp-servers/oauth/callback.
- Local-only servers: install through daemon-backed marketplace flow.
Permissions and endpoint matrix
Third-party apps should request only the minimum permissions needed for each workflow.
| Permission / Tool | Typical Purpose | Primary Endpoint | Execution Method |
|---|---|---|---|
| search_entities | Read people, places, organizations, relationships | /api/mcp/jsonrpc | tools/call: search_entities |
| search_temporal | Read timeline facts and state changes | /api/mcp/jsonrpc | tools/call: search_temporal |
| search_behavioral | Read preferences and communication patterns | /api/mcp/jsonrpc | tools/call: search_behavioral |
| get_user_profile | Get compact user memory snapshot | /api/mcp/jsonrpc | tools/call: get_user_profile |
| store_knowledge | Store new memory with user consent | /api/mcp/jsonrpc | tools/call: store_knowledge |
| tools/list | Discover available tools for token | /api/mcp/tools/list | POST with Bearer token |