# RunAPI Core MCP server

> Provides TypeScript primitives and a factory to build RunAPI Model Context Protocol servers with integrated pricing, contract, and client support.

- Repository: https://github.com/runapi-ai/mcp-core
- Page: https://hostedmcp.org/servers/runapi-ai/mcp-core
- Transport: stdio
- Stars: 0
- License: Apache-2.0

## Install

### Claude Code

```sh
claude mcp add mcp-core -- npx -y @runapi.ai/mcp-core
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp-core": {
      "command": "npx",
      "args": [
        "-y",
        "@runapi.ai/mcp-core"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp-core": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@runapi.ai/mcp-core"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mcp-core","type":"stdio","command":"npx","args":["-y","@runapi.ai/mcp-core"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mcp-core": {
      "command": "npx",
      "args": [
        "-y",
        "@runapi.ai/mcp-core"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add mcp-core -- npx -y @runapi.ai/mcp-core
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp-core]
command = "npx"
args = ["-y", "@runapi.ai/mcp-core"]
```

### Gemini CLI

```sh
gemini mcp add -s user mcp-core npx -- -y @runapi.ai/mcp-core
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp-core": {
      "command": "npx",
      "args": [
        "-y",
        "@runapi.ai/mcp-core"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `RUNAPI_API_KEY` | no | no |  |

## FAQ

### How do I install the RunAPI MCP core library?

You can install it using npm with the command `npm install @runapi.ai/mcp-core`.

### What are the authentication methods for RunAPI?

Authentication is handled via the RUNAPI_API_KEY environment variable or a configuration file located at ~/.config/runapi/config.json.

### Is this a ready-to-run MCP server?

No, this is a library. For a ready-to-run server, you should use @runapi.ai/mcp for the full catalog or @runapi.ai/<model-line>-mcp for specific model lines.

### What version of Node.js is required?

You must use Node.js version 22 or newer.
