MCP Server - Ordinal Knowledge Base

Overview

The Ordinal API exposes an MCP (Model Context Protocol) server that allows AI tools to interact directly with your Ordinal workspace. This enables AI assistants to create posts, manage profiles, retrieve analytics, and more on your behalf.

MCP Server URL

https://app.tryordinal.com/api/mcp

Prerequisites

Before connecting to the MCP server, you’ll need an API key. See the Authentication guide for details on generating an API key.

Install

Select a method below to install the server. After installation, you’ll need to replace YOUR_API_KEY with your actual API key.

Add to Cursor

One-click install for Cursor IDE

Once open, under the Headers section fill in your API Key in the Authorization field as Bearer YOUR_API_KEYOr manually configure by opening the command palette (Cmd+Shift+P / Ctrl+Shift+P), searching for “Open MCP settings”, and adding:

{
  "mcpServers": {
    "ordinal": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://app.tryordinal.com/api/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Run the following command in your terminal:

claude mcp add --transport http ordinal https://app.tryordinal.com/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Verify the connection with:

claude mcp list

Add to Claude

Download and double-click to install

Or manually configure by opening the MCP settings:

Open Settings (Cmd + , on Mac, Ctrl + , on Windows)
Click Developer in the sidebar
Click Edit Config

Add the Ordinal MCP server:

{
  "mcpServers": {
    "ordinal": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://app.tryordinal.com/api/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Restart Claude Desktop to apply the changes.

Add to VS Code

One-click install for VS Code

Or manually create a .vscode/mcp.json file in your project:

{
  "servers": {
    "ordinal": {
      "type": "http",
      "url": "https://app.tryordinal.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Run the following command to add the server:

gemini mcp add --transport http ordinal https://app.tryordinal.com/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Or add to your ~/.gemini/settings.json:

{
  "mcpServers": {
    "ordinal": {
      "httpUrl": "https://app.tryordinal.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Verify with:

gemini mcp list

Run the following command to add the server:

codex mcp add ordinal --url https://app.tryordinal.com/api/mcp \
  --env ORDINAL_API_KEY=YOUR_API_KEY

Or add to your ~/.codex/config.toml:

[mcp_servers.ordinal]
url = "https://app.tryordinal.com/api/mcp"

[mcp_servers.ordinal.http_headers]
Authorization = "Bearer YOUR_API_KEY"

Verify with /mcp in the Codex TUI.

Available Capabilities

Once connected, the MCP server provides AI tools with access to your Ordinal workspace:

Posts

Create, list, retrieve, and delete posts

Profiles

Access connected social profiles

Analytics

Retrieve post and follower analytics

Labels

Manage labels for organizing posts

Approvals

Handle approval workflows

Engagements

Configure auto-engagements

Security

Your API key grants full access to your Ordinal workspace. Keep it secure and never share it publicly.

Environment Variables: Consider storing your API key in an environment variable and referencing it in your MCP config
Workspace Scope: API keys are scoped to a single workspace
Revocation: If compromised, revoke your API key immediately in workspace settings

Troubleshooting

Connection Failed

Verify your API key is correct and hasn’t been revoked
Ensure the URL is exactly https://app.tryordinal.com/api/mcp

Authentication Errors

Confirm the Authorization header format is Bearer YOUR_API_KEY
Check for extra spaces or missing characters in your API key
Try generating a new API key

Tools Not Appearing

Restart your AI tool after configuring the MCP server
Check for JSON syntax errors in your configuration file
Verify the server name matches what you configured

Need Help?

Authentication Guide

Learn how to generate and manage API keys

API Reference

Explore the full API documentation

Overview

Endpoints

​Overview

MCP Server URL

​Prerequisites

​Install

Add to Cursor

Add to Claude

Add to VS Code

​Available Capabilities

Posts

Profiles

Analytics

Labels

Approvals

Engagements

​Security

​Troubleshooting

​Need Help?

Authentication Guide

API Reference

Overview

Prerequisites

Install

Available Capabilities

Security

Troubleshooting

Need Help?