Docs
MCP reference
Everything an MCP client needs: addresses, authentication, tools and limits. For a step-by-step guide per AI, see Connections.
Addresses
One address per MCP. Transport: Streamable HTTP.
Authentication
Sign in with your account (OAuth)
In clients that support OAuth (Claude, ChatGPT and others), just add the MCP address: the client opens the NewAlgorithm page, you sign in and authorize. Access can be revoked at any time in your dashboard, under Keys & apps.
API key
In the others (Cursor, VS Code, Windsurf, Gemini CLI, Codex, n8n…), create a key in your dashboard and send it in the header Authorization: Bearer <your key>. The key is personal: never commit it to a repository or a shared file.
- Authorization server
- https://newalgorithm.io
- Metadata
- https://newalgorithm.io/.well-known/oauth-authorization-server
- PKCE
- S256
- Dynamic client registration
- Yes (Dynamic Client Registration)
Tools
The same in every MCP. All of them are read-only.
na_searchAsk the SpecialistsThe main tool. Takes the technical or functional question (it may include the full error message or stack trace) and returns the evidence from the Specialist chosen by the Manager Agent, with its confidence level and, when the question spans areas, support from a second Specialist.
When to use: Whenever the question is about the MCP's technology: processes, configuration, tax rules, development, APIs, databases, screens and reports.
na_preparePrepare the project contextFor tasks about your own project (a repository or documents your AI can access): confirms the connection and returns the steps for your AI to build the project's context map on your machine. NewAlgorithm never receives the project.
When to use: Once per conversation, when the task involves project material.
na_specialistsList the SpecialistsThe MCP's catalog of Specialists, with each one's area and the evidence policy shared by all of them.
When to use: When you want to know what the MCP covers.
na_routeInspect the routingDiagnostics: shows which Specialist the Manager Agent would route a question to, without searching.
When to use: Diagnostics only; not needed before na_search.
na_versionVersion and statusService version and connection status.
When to use: To check that the connection works.
Limits
- The MCP delivers knowledge and evidence; your AI writes the answer. Double-check the solution in your own environment — especially tax rules, configuration and version.
- The tools are read-only: the MCP never accesses your systems, runs anything on them or changes data.
- The MCP returns evidence excerpts for the question asked; it does not export whole documents or the knowledge base.
- When no Specialist covers the subject, the Manager Agent asks for clarification or reports the lack of coverage instead of making something up.
- Usage is free with no per-account query limit, within the fair use policy. Questions: contato@newalgorithm.io.