> For the complete documentation index, see [llms.txt](https://docs.americanspend.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.americanspend.com/products/mcp.md).

# MCP

The way an agent reads the Spend Graph.

MCP is how an agent reads the Spend Graph. The server URL is:

```
https://platform.americanspend.com/mcp
```

[Sign up](https://www.americanspend.com/mcp/start/). The calls an agent can make are the [MCP Methods](/mcp-methods.md).

### Connect an agent

The first use opens a browser and asks you to sign in to American Spend. Signing in finds your account. On a Team, Enterprise, Business, or Edu workspace, only an admin can add a connector, so check before you pay.

#### Claude

Add American Spend as a custom connector: Customize, then Connectors, then Add custom connector, and paste the URL. You can also [add it in Claude](https://claude.ai/customize/connectors?modal=add-custom-connector\&connectorName=American+Spend\&connectorUrl=https%3A%2F%2Fplatform.americanspend.com%2Fmcp) with the name and URL already filled in.

#### ChatGPT

On a paid plan, with Developer mode on: Plugins, then Add, then Add custom MCP server, and paste the URL. On a phone, open the menu, tap the settings gear, then Plugins, Add, Add custom MCP server.

#### Claude Code

```
claude mcp add --transport http AmericanSpend https://platform.americanspend.com/mcp
```

#### Codex

```
codex mcp add AmericanSpend --url https://platform.americanspend.com/mcp
```

Codex opens a browser and asks you to sign in.

#### Cursor

Settings, then Customize, then MCPs, then New MCP Server. Paste:

```json
{
  "mcpServers": {
    "AmericanSpend": {
      "url": "https://platform.americanspend.com/mcp"
    }
  }
}
```

Cursor asks you to sign in the first time you use it.

#### VS Code

Open the Command Palette with ⌘⇧P (Ctrl+Shift+P on Windows and Linux). Run "MCP: Add Server", select HTTP, and paste the server URL.

#### Antigravity

From the agent panel's menu, open MCP Servers, then Manage MCP Servers, then View raw config. Paste:

```json
{
  "mcpServers": {
    "AmericanSpend": {
      "serverUrl": "https://platform.americanspend.com/mcp"
    }
  }
}
```

#### Any other agent

Add this URL as a remote MCP server, then complete authentication with OAuth.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.americanspend.com/products/mcp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.