Cortex for MCP
Give a compatible agent access to Cortex through the hosted MCP server. Retrieve Modules and their dependencies from the same Account.
Remote HTTP · All integrations
Knowledge in Cortex
Your project requirements
Your team’s standards
The reasons behind each decision
Your agent through MCP
Knowledge available before the next action
Connect through MCP
Start with one agent. Follow the guide through Account authorization, instructions, and a real connection check.
Set up the connection
Use a client that supports remote HTTP MCP and the required OAuth flow. Guided setup explains how to enable Cortex in a Cloud Project, register the client, and connect it.
Choose your Socra Account
Configure the hosted server at https://cortex.socra.cloud/mcp. Complete the client’s authorization and select the intended Socra Account.
New to Cortex? Create your Account. If the agent is already connected to the intended Account, continue.
Set up tools and guidance
Add Cortex guidance to the client’s persistent or project instructions. Tool access alone does not tell the agent when to retrieve knowledge.
Enable all Cortex tools and use the client's Cortex-scoped always-allow setting when available. Prefer a server-wide setting that includes newly added tools. Controls and available choices depend on the host. Your organization’s policy still applies. Follow guided setup.
Check the connection
Start a new session and send this prompt. Confirm a real Cortex call returns a Module list. An empty list is valid. Check persistent guidance separately; a text-only answer or an access error does not verify the connection.
Connect through a shared protocol
Your team may use an agent that has no dedicated Cortex plugin. It still needs a way to read the knowledge behind the work.
A Module stores current knowledge about how one part of a system should work and why. When your agent flashes a Module, Cortex returns it with its declared dependencies. Your agent then checks that knowledge against the work in front of it.
Keep the knowledge your next task will need
Your agent preserves useful decisions as you work and updates the knowledge when requirements change. You choose whether it saves changes or recommends them for approval.
You supply the judgment
Build, review, and explain decisions as usual. Your agent handles writing and organizing the useful knowledge.
Your agent keeps it useful
The agent maintains the knowledge and retrieves it for later work. It checks current evidence before making a change.
See how retrieval works in Codex
This September 5 recording shows Cortex retrieval. Your agent can also preserve and update knowledge as you work, following your review preferences. The recording uses Codex; follow the MCP setup steps above for your agent.
Your work becomes reusable knowledge
No separate knowledge-writing task. Your agent can preserve what comes out of ordinary work and bring it into the next task.
Illustrative example: a scheduling app for tutors. Replace the details with your own project and choose whether your agent saves changes or recommends them for approval.
Work on your product
Give your agent the task you already wanted to do. With Cortex connected and its guidance in place, it can preserve the useful knowledge along the way.
The agent can preserve the app’s purpose in a product Module.
Explain what needs to change
Review the work as usual. The agent can preserve your correction and its reason, and connect it to the knowledge it needs.
The agent can connect customer knowledge to the product it describes.
Continue with the next task
Your agent retrieves the relevant saved knowledge before working, so you don’t have to explain the same requirements again.
A flash of product-customer includes product first, followed by the customer knowledge.
What this flash includes
product
The app’s purpose. Included as a dependency.
product-customer
Who uses the app. The Module the agent retrieves for this task.
Good to know
What can I do through MCP?
The hosted Cortex MCP server exposes knowledge and work through tools your agent can call. A compatible client can find a Module, flash its dependencies, and work with Issues.
Can I use the same knowledge with another agent?
Yes. Connect each agent to the same Socra Account. Each can retrieve the Modules it has permission to access. Setup is separate for each agent.
What should I know before connecting?
Client support varies. A remote MCP connection does not install the SessionStart hook supplied by supported coding-agent plugins.
Who controls the knowledge?
You choose whether your agent saves useful knowledge as you work or recommends changes for approval. Modules have owners and version history. Your Account permissions and host tool approvals still apply.
Cortex is included with Coagent. See pricing for the plan and usage terms.
