# MCP Server

The **Inqud MCP** server exposes our public OpenAPI spec and documentation as tools that any MCP-compatible AI client can call. Once connected, your AI assistant can search endpoints, inline schemas, and fetch docs pages on demand — without leaving your editor.<br>

* **Endpoint:** `https://mcp.inqud.com/v1/mcp`
* **Transport:** Streamable HTTP (JSON-RPC over HTTP POST)
* **Auth:** none

### Setup

{% tabs %}
{% tab title="Claude Code" %}
One-line install:

```bash
claude mcp add --transport http inqud https://mcp.inqud.com/v1/mcp
```

Or add manually to `~/.claude.json` (user scope) or `.mcp.json` (project scope):

```json
{
  "mcpServers": {
    "inqud": {
      "type": "http",
      "url": "https://mcp.inqud.com/v1/mcp"
    }
  }
}
```

Verify with `/mcp` inside Claude Code — `inqud` should be listed as `connected`.
{% endtab %}

{% tab title="Cursor" %}
Add to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per-project):

```json
{
  "mcpServers": {
    "inqud": {
      "url": "https://mcp.inqud.com/v1/mcp"
    }
  }
}
```

Restart Cursor. Open **Cursor Settings → Tools & MCPs → User MCP Servers** (`Cmd+Shift+J`) to confirm the server is green and lists 5 tools.
{% endtab %}

{% tab title="Codex CLI" %}
Add to `~/.codex/config.toml`:

```toml
[mcp_servers.inqud]
url = "https://mcp.inqud.com/v1/mcp"
```

Codex auto-detects the Streamable HTTP transport from the `url` field. Run `codex` and type `/mcp` to verify the server is listed.

If your Codex version fails to initialize the HTTP server (see [openai/codex#11284](https://github.com/openai/codex/issues/11284)), fall back to the [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) stdio bridge:

```toml
[mcp_servers.inqud]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.inqud.com/v1/mcp"]
```

{% endtab %}

{% tab title="Windsurf" %}
Add to `~/.codeium/windsurf/mcp_config.json` (on Windows: `%USERPROFILE%\.codeium\windsurf\mcp_config.json`):

```json
{
  "mcpServers": {
    "inqud": {
      "serverUrl": "https://mcp.inqud.com/v1/mcp"
    }
  }
}
```

Open the Cascade panel → **MCPs** icon (or **Windsurf Settings → Cascade → MCP Servers**) and click **Refresh**. The `inqud` entry should appear with 5 tools.
{% endtab %}

{% tab title="Other clients" %}
Any MCP client that only supports stdio can use the [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) bridge:

```bash
npx -y mcp-remote https://mcp.inqud.com/v1/mcp
```

Wire that command into your client's MCP config as a stdio server. This works for Cline, Continue, Zed, and others.

For raw HTTP debugging:

```bash
curl -s -X POST https://mcp.inqud.com/v1/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
```

{% endtab %}
{% endtabs %}

### Available tools

| Tool                      | What it does                                                                |
| ------------------------- | --------------------------------------------------------------------------- |
| `lookup_list_endpoints`   | List every endpoint in the public API (method, path, summary, tag).         |
| `lookup_search_endpoints` | Ranked search over endpoints by keyword.                                    |
| `lookup_get_endpoint`     | Full operation detail for a given method + path, with all `$ref` s inlined. |
| `lookup_search_docs`      | Search docs.inqud.com.                                                      |
| `lookup_get_doc_page`     | Fetch the full markdown of a docs page by URL.                              |

### Try it

Once connected, prompt your agent like this:

* *"How do I verify the signature on Inqud webhooks? Show me a code example."*
* *"What's the request body for creating a crypto-acquiring checkout? Show me the schema with all required fields."*
* *"Show me how to create an on-ramp checkout via the API — request shape and response."*
* *"How do I set up webhooks to track mass payout batch and individual payment status updates?"*
* *"Walk me through the crypto recurring flow from creating a plan to an active subscription, and show me the endpoint to create a plan."*

The agent will pick the right tool (`lookup_search_endpoints`, `lookup_get_endpoint`, `lookup_search_docs`, `lookup_get_doc_page`) automatically.


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.inqud.com/developer/ai-and-llm-tools/mcp-server.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.