> ## Documentation Index
> Fetch the complete documentation index at: https://readme.amana-dev.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Amana MCP server

> Connect Claude, ChatGPT, Cursor, VS Code, and other AI tools to your Amana account with the Amana MCP server.

The Amana MCP server connects your favorite AI tool to your Amana account through the [Model Context Protocol](https://modelcontextprotocol.io). After you connect, you can ask your AI assistant to:

* View your portfolio and positions.
* Place trades.
* Check market news.
* Work with other account features.

The server is available at:

```text theme={null}
https://mcp.amana-dev.com/mcp
```

<Warning>
  Trades placed through your AI tool are real orders with real financial effects. Review every order your assistant proposes before you approve it.
</Warning>

## Install in one click

Choose your tool to add the Amana MCP server automatically.

<CardGroup cols={2}>
  <Card title="Add to Cursor" icon="mouse-pointer-click" href="https://cursor.com/en/install-mcp?name=amana&config=eyJ1cmwiOiJodHRwczovL21jcC5hbWFuYS1kZXYuY29tL21jcCJ9">
    Opens Cursor and adds the Amana server to your MCP settings.
  </Card>

  <Card title="Add to VS Code" icon="code" href="https://vscode.dev/redirect/mcp/install?name=amana&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.amana-dev.com%2Fmcp%22%7D">
    Opens VS Code and adds the Amana server for GitHub Copilot agent mode.
  </Card>
</CardGroup>

After you install the server, sign in to your Amana account if your tool prompts you to authenticate.

## Connect manually

Use these steps if your tool does not support one-click install.

<Tabs>
  <Tab title="Claude">
    1. In Claude, open **Settings** > **Connectors**.
    2. Click **Add custom connector**.
    3. Enter `Amana` as the name and `https://mcp.amana-dev.com/mcp` as the URL.
    4. Click **Add**, then sign in to your Amana account when prompted.
    5. In a new chat, enable the Amana connector from the tools menu.
  </Tab>

  <Tab title="Claude Code">
    Run this command in your terminal:

    ```bash theme={null}
    claude mcp add --transport http amana https://mcp.amana-dev.com/mcp
    ```

    Then run `/mcp` inside Claude Code to authenticate with your Amana account.
  </Tab>

  <Tab title="ChatGPT">
    1. In ChatGPT, open **Settings** > **Apps & Connectors**.
    2. Under **Advanced settings**, turn on **Developer mode**.
    3. Click **Create** to add a new connector.
    4. Enter `Amana` as the name and `https://mcp.amana-dev.com/mcp` as the MCP server URL.
    5. Click **Create**, then sign in to your Amana account when prompted.
  </Tab>

  <Tab title="Cursor">
    Add the server to `~/.cursor/mcp.json`:

    ```json mcp.json theme={null}
    {
      "mcpServers": {
        "amana": {
          "url": "https://mcp.amana-dev.com/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="VS Code">
    Add the server to `.vscode/mcp.json` in your workspace:

    ```json .vscode/mcp.json theme={null}
    {
      "servers": {
        "amana": {
          "type": "http",
          "url": "https://mcp.amana-dev.com/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Windsurf">
    Add the server to `~/.codeium/windsurf/mcp_config.json`:

    ```json mcp_config.json theme={null}
    {
      "mcpServers": {
        "amana": {
          "serverUrl": "https://mcp.amana-dev.com/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Other tools">
    Most MCP clients that support remote servers accept a server URL. Add a new server with the Streamable HTTP transport and this URL:

    ```text theme={null}
    https://mcp.amana-dev.com/mcp
    ```
  </Tab>
</Tabs>

## Try it out

After you connect, ask your assistant questions like:

* "Show me my current portfolio."
* "What's the latest news on my holdings?"
* "Buy 5 shares of AAPL at market price."


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.