> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pazy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

> Complete guide to integrate Pazy with MCP Clients

<Warning>
  **Beta Release**: Pazy MCP is currently in beta. To get your API key, please email us at [support@pazy.io](mailto:support@pazy.io?subject=API%20Key%20Request%20for%20Pazy%20MCP\&body=Hello%2C%0A%0AI%20would%20like%20to%20request%20an%20API%20key%20for%20Pazy%20MCP%20integration.%0A%0AThank%20you%21).
</Warning>

<CardGroup cols={2}>
  <Card title="Claude Desktop" icon="robot" href="#client-setup">
    Set up Pazy with Claude Desktop for powerful financial AI conversations
  </Card>

  <Card title="Cursor" icon="code" href="#cursor">
    Integrate Pazy with Cursor for AI-powered financial coding assistance
  </Card>
</CardGroup>

## What is MCP Server?

<Info>
  The Model Context Protocol (MCP) allows AI assistants to securely access external data sources in real-time, enabling more intelligent and contextual responses.
</Info>

## Prerequisites

<Steps>
  <Step title="Node.js Installation">
    Ensure you have Node.js version 14 or higher installed on your system.

    <CodeGroup>
      ```bash macOS/Linux theme={null}
      node --version
      ```

      ```cmd Windows theme={null}
      node --version
      ```
    </CodeGroup>

    <Note>
      If you see an error, download Node.js from [nodejs.org](https://nodejs.org/)
    </Note>
  </Step>

  <Step title="Pazy API Key">
    To obtain your Pazy API key, Please mail [support@pazy.io](mailto:support@pazy.io?subject=API%20Key%20Request%20for%20Pazy%20MCP\&body=Hello%2C%0A%0AI%20would%20like%20to%20request%20an%20API%20key%20for%20Pazy%20MCP%20integration.%0A%0AThank%20you%21)

    <Warning>
      Keep your API key secure and never share it publicly or commit it to version control.
    </Warning>
  </Step>

  <Step title="AI Client">
    Have either Claude Desktop or Cursor installed on your machine.
  </Step>
</Steps>

## Client Setup

<Tabs>
  <Tab title="Claude Desktop">
    ### Step 1: Access Configuration

    <Steps>
      <Step title="Download Claude Desktop">
        If you haven't already, download [Claude Desktop](https://claude.ai/download) for your operating system.
      </Step>

      <Step title="Open Settings">
        <AccordionGroup>
          <Accordion icon="apple" title="macOS">
            1. Click **"Claude"** in the menu bar
            2. Select **"Settings..."**
            3. Navigate to **"Developer"** in the left sidebar
            4. Click **"Edit Config"**
          </Accordion>

          <Accordion icon="windows" title="Windows">
            1. Right-click the Claude system tray icon
            2. Select **"Settings..."**
            3. Navigate to **"Developer"** in the left sidebar
            4. Click **"Edit Config"**
          </Accordion>
        </AccordionGroup>
      </Step>
    </Steps>

    ### Step 2: Configure Pazy

    Replace your configuration file contents with:

    <CodeGroup>
      ```json claude_desktop_config.json theme={null}
      {
        "mcpServers": {
          "pazy": {
            "command": "npx",
            "args": [
              "mcp-remote",
              "https://mcp.pazy.io/mcp",
              "--header",
              "Authorization:Api-Key ${PAZY_API_KEY}",
              "--transport",
              "http-only"
            ],
            "env": {
              "PAZY_API_KEY": "your-pazy-api-key-here"
            }
          }
        }
      }
      ```
    </CodeGroup>

    <Warning>
      Replace `your-pazy-api-key-here` with your actual Pazy API key.
    </Warning>

    ### Step 3: Verify Setup

    1. **Restart Claude Desktop** completely
    2. Look for the **hammer icon (🔨)** in the bottom-left corner
    3. Click the icon to see available Pazy tools

    <Tip>
      If you don't see the hammer icon, check the troubleshooting section below.
    </Tip>
  </Tab>

  <Tab title="Cursor">
    ### One-Click Setup (Recommended)

    <Info>
      The easiest way to set up Pazy with Cursor is using our one-click installer. You'll just need to add your API key afterward.
    </Info>

    <Steps>
      <Step title="Click to Install">
        Click the button below to automatically configure Pazy MCP in Cursor:

        <a href="https://cursor.com/install-mcp?name=pazy&config=eyJjb21tYW5kIjoibnB4IG1jcC1yZW1vdGUgaHR0cHM6Ly9tY3AucGF6eS5pby9tY3AgLS1oZWFkZXIgQXV0aG9yaXphdGlvbjoke1BBWllfQVBJX0tFWX0gLS10cmFuc3BvcnQgaHR0cC1vbmx5IiwiZW52Ijp7IlBBWllfQVBJX0tFWSI6InlvdXItcGF6eS1hcGkta2V5LWhlcmUifX0%3D">
          <img className="block dark:hidden" src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Install MCP Server - Light Mode" style={{ width: '200px', height: 'auto', margin: '10px 0' }} />

          <img className="hidden dark:block" src="https://cursor.com/deeplink/mcp-install-light.svg" alt="Install MCP Server - Dark Mode" style={{ width: '200px', height: 'auto', margin: '10px 0' }} />
        </a>
      </Step>

      <Step title="Add Your API Key">
        After installation, Cursor will open the MCP configuration. Simply replace `your-pazy-api-key-here` with your actual Pazy API key.
      </Step>

      <Step title="Restart Cursor">
        Close and restart Cursor to activate the Pazy integration.
      </Step>
    </Steps>

    ### Manual Setup (Alternative)

    <Accordion title="Manual Configuration Steps">
      <Steps>
        <Step title="Open Cursor Settings">
          Go to **Cursor → Settings → Cursor Settings**
        </Step>

        <Step title="Navigate to MCP Tools">
          1. Find **"MCP Tools"** section in the settings
          2. Click **"Add new MCP server"**
        </Step>

        <Step title="Add Pazy Configuration">
          Add the following JSON configuration to the mcp.json file:

          ```json theme={null}
          {
            "mcpServers": {
              "pazy": {
                "command": "npx",
                "args": [
                  "mcp-remote",
                  "https://mcp.pazy.io/mcp",
                  "--header",
                  "Authorization:Api-Key ${PAZY_API_KEY}",
                  "--transport",
                  "http-only"
                ],
                "env": {
                  "PAZY_API_KEY": "your-pazy-api-key-here"
                }
              }
            }
          }
          ```

          <Warning>
            Replace `your-pazy-api-key-here` with your actual Pazy API key.
          </Warning>
        </Step>

        <Step title="Save and Restart">
          Save the mcp.json file and restart Cursor to activate the Pazy integration.
        </Step>
      </Steps>
    </Accordion>
  </Tab>
</Tabs>

## Troubleshooting

<AccordionGroup>
  <Accordion icon="server" title="Server Not Connecting">
    <Steps>
      <Step title="Verify API Key">
        Ensure your API key is correctly set
      </Step>

      <Step title="Check Node.js">
        Run `node --version` to confirm Node.js is installed.
      </Step>

      <Step title="Review Logs">
        <Tabs>
          <Tab title="Claude Desktop">
            **macOS**: `~/Library/Logs/Claude/mcp*.log`

            **Windows**: `%APPDATA%\Claude\logs\mcp*.log`
          </Tab>

          <Tab title="Cursor">
            Check the developer console for MCP-related errors.
          </Tab>
        </Tabs>
      </Step>
    </Steps>
  </Accordion>

  <Accordion icon="wrench" title="Tools Not Appearing">
    <CardGroup cols={2}>
      <Card title="Configuration Issues" icon="file-code">
        * Verify JSON syntax is correct, Ensure all required fields are present, Check for typos in the configuration
      </Card>
    </CardGroup>
  </Accordion>

  <Accordion icon="bug" title="Common Errors">
    <AccordionGroup>
      <Accordion title="&#x22;Command not found&#x22;">
        **Solution**: Install Node.js from [nodejs.org](https://nodejs.org/)

        ```bash theme={null}
        # Verify installation
        node --version
        npm --version
        ```
      </Accordion>

      <Accordion title="&#x22;Authentication failed&#x22;">
        **Solution**: Check your API key

        * Ensure it's correctly copied
      </Accordion>

      <Accordion title="&#x22;Connection refused&#x22;">
        **Solution**: Network connectivity

        * Check internet connection
        * Verify firewall settings
      </Accordion>
    </AccordionGroup>
  </Accordion>
</AccordionGroup>

## Getting Help

<CardGroup cols={3}>
  <Card title="Documentation" icon="book" href="https://modelcontextprotocol.io/quickstart/user">
    Official MCP documentation and guides
  </Card>

  <Card title="Pazy Support" icon="headset" href="mailto:support@pazy.io">
    Contact our support team for assistance
  </Card>

  <Card title="Community" icon="users" href="https://github.com/modelcontextprotocol">
    Join the MCP community discussions
  </Card>
</CardGroup>

<Note>
  This configuration works with most modern MCP clients. If you're using a different AI assistant that supports the MCP Protocol, the same setup should work with minimal modifications.
</Note>