Newton MCP

The Newton MCP server gives any MCP-aware AI coding tool direct access to Aghanim's product documentation and OpenAPI spec. Once connected, your agent can search docs, fetch individual pages, browse API groups, and inspect request/response schemas — all without leaving the editor.

Endpoint: https://mcp.aghanim.com/sse (SSE transport, OAuth 2.0 / Auth0)

Claude Code

If you're using Claude Code, the easiest path is the one-command plugin install — it bundles the MCP server, the webhook quick-start skill, and a matching slash command.

To add Newton MCP manually without the plugin, run this command in your terminal:

claude mcp add --transport sse aghanim https://mcp.aghanim.com/sse

Scope flags control where the configuration is saved:

Flag	Scope	Config location
--scope local (default)	Current project, current user	.mcp.json in the project root (not shared)
--scope project	Current project, all team members	.mcp.json committed to the repo
--scope user	All projects, current user	User-level Claude Code config

Authenticate by running /mcp in Claude Code and completing the OAuth flow when prompted.

Cursor

Cursor supports remote MCP servers through mcp.json. Use ~/.cursor/mcp.json for a global configuration that applies to every project, or .cursor/mcp.json at the root of a project for a project-specific configuration.

Global (~/.cursor/mcp.json)

{
  "mcpServers": {
    "aghanim": {
      "url": "https://mcp.aghanim.com/sse"
    }
  }
}

Per project (.cursor/mcp.json)

{
  "mcpServers": {
    "aghanim": {
      "url": "https://mcp.aghanim.com/sse"
    }
  }
}

After saving the file:

1. Restart Cursor (or reload the MCP servers from Settings → MCP).
2. Open the Cursor chat and ask a question that requires Aghanim docs — for example: "Use the aghanim MCP to fetch the player.verify schema".
3. On the very first call, Cursor opens a browser for Aghanim SSO. Sign in once.

Claude Desktop

1. Open Settings → Connectors.
2. Click Add Connector and enter the URL: https://mcp.aghanim.com/sse
3. Complete the OAuth flow to connect your Aghanim account.

备注

Remote MCP servers in Claude Desktop are configured through Settings → Connectors, not claude_desktop_config.json.

VS Code (GitHub Copilot)

Create a .vscode/mcp.json file in your workspace:

{
  "servers": {
    "aghanim": {
      "type": "sse",
      "url": "https://mcp.aghanim.com/sse"
    }
  }
}

Then open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run MCP: List Servers. Start the Aghanim server and complete the OAuth flow when prompted.

Windsurf

1. Open Windsurf Settings (Cmd+, on Mac) and search for MCP.
2. Click View raw config to open mcp_config.json.
3. Add the Aghanim server configuration:

{
  "mcpServers": {
    "aghanim": {
      "serverUrl": "https://mcp.aghanim.com/sse"
    }
  }
}

Save and restart Windsurf. Complete the OAuth flow when prompted.

Codex

Add the Aghanim server to ~/.codex/config.toml:

[mcp_servers.aghanim]
url = "https://mcp.aghanim.com/sse"

Then authenticate by running:

codex mcp login aghanim

Complete the OAuth flow to connect your Aghanim account.

Project-level configuration: to share the configuration with your team, create a .codex/config.toml file in your project root with the same server block.

Other tools

If your AI tool isn't listed above but supports MCP, connect using the SSE URL:

Transport	URL
SSE (Server-Sent Events)	https://mcp.aghanim.com/sse

Most MCP clients accept a JSON configuration:

{
  "mcpServers": {
    "aghanim": {
      "type": "sse",
      "url": "https://mcp.aghanim.com/sse"
    }
  }
}

If your client only supports local stdio servers, use the mcp-remote bridge:

{
  "mcpServers": {
    "aghanim": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.aghanim.com/sse"]
    }
  }
}

Verify the connection

Once the server is wired up, ask the agent to run any of these tools — they confirm the round-trip end to end:

• mcp__aghanim__list_api_groups — lists the Aghanim OpenAPI groups.
• mcp__aghanim__search_docs with a query like "player.verify" — returns matching doc pages.

If a call fails with an authentication error, complete the SSO login in the browser window your client opened and retry.

Troubleshooting

The OAuth browser window never opened. Check that the URL in your config is exactly https://mcp.aghanim.com/sse and that the server name in mcpServers is unique (no other entry uses the same key). Restart your editor after changing the config.

I get a 403 when my agent fetches Aghanim docs. The host docs.aghanim.com blocks anonymous requests. Always use mcp__aghanim__fetch_doc or mcp__aghanim__search_docs — never fetch the docs URL directly.

Authentication fails even after I completed the OAuth flow. Try clearing the session: look for a "Disconnect" or "Clear authentication" option in your tool's MCP settings, then re-authorize.

FAQ

Is there a streamable-HTTP endpoint?

Not yet. Today every client connects over SSE at https://mcp.aghanim.com/sse.

Can I use Newton MCP in a fully automated pipeline without a human in the loop?

No. Newton MCP requires OAuth user authentication. A user must complete the browser login at least once per machine; the session then persists automatically.

Next steps

• Run the webhook quick-start skill to scaffold player.verify, item.add, and item.remove in your project.
• Browse available tools.

需要技术支持？
联系我们的集成技术团队： [email protected]