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.

MCPAddress
TOTVSTOTVShttps://totvs.mcp.newalgorithm.io/mcp
SAPSAPhttps://sap.mcp.newalgorithm.io/mcp
OmieOmiehttps://omie.mcp.newalgorithm.io/mcp
SankhyaSankhyahttps://sankhya.mcp.newalgorithm.io/mcp

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 Specialists

The 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 context

For 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 Specialists

The 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 routing

Diagnostics: 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 status

Service 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.