MCP tools

The SoluCortex MCP server exposes four tools. Your agent calls them automatically once connected — this is the reference for what each one does and its parameters.

Tool	What it does	When
`solucortex_recall`	Builds living context for a task, ranked by semantic similarity + importance.	At the start of a task, before touching code.
`solucortex_search`	Ad-hoc semantic search over the project's memories.	Specific questions mid-task.
`solucortex_remember`	Records a memory (stored and traced as an authorized agent).	At close, or on a relevant technical decision.
`solucortex_list_memories`	Lists memories without semantic search.	Quick inspection or audit.

solucortex_recall

Builds the operational context for what the agent is about to do. Returns the most relevant memories ranked by semantic similarity and importance.

Parameter	Type	Description
`query`	string · required	Describe the current task/module in natural language.
`project_id`	string · optional	Project UUID. Defaults to `SOLUCORTEX_PROJECT_ID`.

solucortex_search

Ad-hoc semantic search across the project's memories — for a specific question in the middle of a task.

Parameter	Type	Description
`query`	string · required	Question or topic to search across the project's memories.
`limit`	int · optional	Max memories to return (1–50). Default 10.
`project_id`	string · optional	Project UUID. Defaults to `SOLUCORTEX_PROJECT_ID`.

solucortex_remember

Records a new memory. As an authorized agent (Bearer API key), the memory is stored and traced. Depending on the project's moderation policy it may be approved automatically or left pending your review in the dashboard.

Parameter	Type	Description
`type`	string · required	Memory type. See the canonical vocabulary below.
`title`	string · required	Short, clear title (~80 chars).
`content`	string · required	What to remember, why it matters, where it applies and what it prevents.
`importance`	int · optional	Priority 1–10. Default 5. 8–9 for important decisions/risks/conventions.
`project_id`	string · optional	Project UUID. Defaults to `SOLUCORTEX_PROJECT_ID`.

Canonical type vocabulary: architecture, decision, risk, convention, bug_history, tech_debt, sensitive_module, learning, external_integration. See Memory types.

🔒 Never store real secrets in a memory. Record the location, type, severity and action taken with a redacted reference instead.

solucortex_list_memories

Lists the project's memories without semantic search — useful for a quick inspection or audit.

Parameter	Type	Description
`limit`	int · optional	Max memories to return (1–100). Default 20.
`project_id`	string · optional	Project UUID. Defaults to `SOLUCORTEX_PROJECT_ID`.

💡 Prefer solucortex_recall at the start of a task and solucortex_remember at the end. That loop — recall before, remember after — is what keeps the memory alive across sessions.