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

# Build AIR Kit integrations with AI assistants

> Connect AIR Kit documentation to Cursor, Claude, or other AI coding assistants via MCP for real-time access to SDK references, API docs, and code examples.

Connect the Moca Network documentation MCP server to your IDE or AI assistant for real-time access to AIR Kit documentation, API references, and code examples. When you connect the MCP server, AI assistants can search the documentation directly to help you build faster and more accurately.

## Connect your AI tools

Connect the Moca Network documentation MCP server to your preferred AI tool:

<Tabs>
  <Tab title="Claude">
    <Steps>
      <Step title="Get your MCP server URL">
        Your MCP server URL is: `https://docs.moca.network/mcp`
      </Step>

      <Step title="Add the Moca Network MCP server to Claude">
        1. Navigate to the [Connectors](https://claude.ai/settings/connectors) page in the Claude settings.
        2. Select **Add custom connector**.
        3. Add the Moca Network MCP server:
           * Name: `MocaNetwork`
           * URL: `https://docs.moca.network/mcp`
        4. Select **Add**.
      </Step>

      <Step title="Access the MCP server in your chat">
        1. When using Claude, select the attachments button (the plus icon).
        2. Select the MocaNetwork MCP server.
        3. Ask Claude a question about Moca Network or AIR Kit.
      </Step>
    </Steps>

    See the [Model Context Protocol documentation](https://modelcontextprotocol.io/docs/tutorials/use-remote-mcp-server#connecting-to-a-remote-mcp-server) for more details.
  </Tab>

  <Tab title="Claude Code">
    <Steps>
      <Step title="Get your MCP server URL">
        Your MCP server URL is: `https://docs.moca.network/mcp`
      </Step>

      <Step title="Add the MCP server to Claude Code">
        Run the following command:

        ```bash theme={null}
        claude mcp add --transport http MocaNetwork https://docs.moca.network/mcp
        ```
      </Step>

      <Step title="Test the connection">
        Verify the connection by running:

        ```bash theme={null}
        claude mcp list
        ```
      </Step>
    </Steps>

    See the [Claude Code documentation](https://docs.anthropic.com/en/docs/claude-code/mcp#installing-mcp-servers) for more details.
  </Tab>

  <Tab title="Cursor">
    <Steps>
      <Step title="Get your MCP server URL">
        Your MCP server URL is: `https://docs.moca.network/mcp`
      </Step>

      <Step title="Open MCP settings">
        1. Use <kbd>Command</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> on Windows) to open the command palette.
        2. Search for "Open MCP settings".
        3. Select **Add custom MCP**. This opens the `mcp.json` file.
      </Step>

      <Step title="Configure the Moca Network MCP server">
        In `mcp.json`, add:

        ```json theme={null}
        {
          "mcpServers": {
            "MocaNetwork": {
              "url": "https://docs.moca.network/mcp"
            }
          }
        }
        ```
      </Step>

      <Step title="Test the connection">
        In Cursor's chat, ask "What tools do you have available?" Cursor should show the MocaNetwork MCP server as an available tool.
      </Step>
    </Steps>

    See the [Cursor documentation](https://docs.cursor.com/en/context/mcp#installing-mcp-servers) for more details.
  </Tab>

  <Tab title="VS Code">
    <Steps>
      <Step title="Get your MCP server URL">
        Your MCP server URL is: `https://docs.moca.network/mcp`
      </Step>

      <Step title="Create MCP configuration">
        Create a `.vscode/mcp.json` file in your project root.
      </Step>

      <Step title="Configure the Moca Network MCP server">
        In `.vscode/mcp.json`, add:

        ```json theme={null}
        {
          "servers": {
            "MocaNetwork": {
              "type": "http",
              "url": "https://docs.moca.network/mcp"
            }
          }
        }
        ```
      </Step>
    </Steps>

    See the [VS Code documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) for more details.
  </Tab>
</Tabs>

<Tip>
  You can also use the contextual menu on any page of the documentation to copy the MCP server URL or install it directly into Cursor or VS Code.
</Tip>

## Setup with other agents

The Moca skill works with any tool that supports the [Agent Skills](https://agentskills.io/home) standard, including Cursor, VS Code Copilot, Gemini CLI, OpenAI Codex, and more.

Run:

```bash theme={null}
npx skills add https://docs.moca.network
```

The CLI detects your installed agents and places the skill in the correct directory for each one.

## What the skill provides

| Feature                | Description                                                                                                                                                            |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Quick references       | SDK install (`@mocanetwork/airkit`), platform matrix, provider and wallet APIs, and REST credential endpoints                                                          |
| Decision guidance      | Account-only vs credential flows, embedded AIR login vs bring-your-own auth, and client vs server signing with Partner JWT                                             |
| Workflows              | Step-by-step sequences for onboarding, issuance, verification, Issue on Behalf, and advanced flows like paymaster or session keys where relevant                       |
| Common gotchas         | Initialization and iframe setup, [JWKS](/airkit/usage/jwks-setup) and JWT errors, polling issuance until credentials are on-chain, and schema or verification pitfalls |
| Verification checklist | Partner ID, environment (sandbox vs production), chain allowlists, auth headers, and error handling before you ship                                                    |

## Credential E2E checklist for agents

Before generating issue/verify app code, confirm all three. Skipping any one of these makes the generated code unable to complete `issueCredential` or `verifyCredential` at runtime.

1. **JWKS route implemented and reachable over HTTPS** — `GET /api/.well-known/jwks` (or your equivalent path) returns a JSON document with a `keys` array.
2. **Dashboard JWKS URL set to that exact path** — registered in **Account → General Settings → JWKS URL** as the full URL.
3. **`PARTNER_PRIVATE_KEY` server-only; JWT `kid` matches a key in the JWKS** — the value you set in the JWT header must appear as `keys[].kid` in the JWKS response.

Full procedure on the [JWKS endpoint setup](/airkit/usage/jwks-setup) page.

## Static docs files

If your AI tool does not support MCP yet, you can use one of Moca Network's static documentation files instead.

<Warning>
  Static files are snapshots and may not include the latest updates. Use MCP when possible for always-current docs.
</Warning>

## Which file should I use?

* **`llms.txt`** — A curated overview of Moca Network. Use it to route an agent to the right docs, understand product structure, and choose the right integration path.
* **`llms-full.txt`** — A full static snapshot of the documentation. Use it when your tool needs more exhaustive reference material in one file.

## Setup with Cursor

<Steps>
  <Step title="Open docs settings">
    Go to **Settings** → **Features** → **Docs**.
  </Step>

  <Step title="Add the overview file">
    Click **Add new doc** and paste: `https://docs.moca.network/llms.txt`
  </Step>

  <Step title="Optionally add the full snapshot">
    If your agent needs deeper static reference coverage, add: `https://docs.moca.network/llms-full.txt`
  </Step>

  <Step title="Reference in chat">
    Use **@docs** → **Moca** in your AI chat to reference the documentation.
  </Step>
</Steps>

## Setup with Claude Desktop

<Steps>
  <Step title="Download the overview file">
    Download the curated overview from: [https://docs.moca.network/llms.txt](https://docs.moca.network/llms.txt)
  </Step>

  <Step title="Optionally download the full snapshot">
    Download the full documentation snapshot from: [https://docs.moca.network/llms-full.txt](https://docs.moca.network/llms-full.txt)
  </Step>

  <Step title="Add to your project">
    Save one or both files in your project directory or another known location on your system.
  </Step>

  <Step title="Reference in chat">
    Drag and drop the file into your Claude Desktop chat, or use the attachment button to upload it. Claude will then have access to the uploaded Moca Network documentation context for that conversation.
  </Step>
</Steps>