Developer / MCP

Connect X Research to Claude and OpenAI.

Use the hosted MCP endpoint to search repositories, read grounded analyses, create repositories, and add resources from external AI clients.

Hosted Endpoint

Use this endpoint in Claude Desktop, Claude Code, OpenAI Codex, or OpenAI Responses.

MCP URL

https://your-app-url.com/api/mcp

Transport

Hosted HTTP MCP at /api/mcp

Auth

Authorization: Bearer sk_live_...

Clients

Claude Desktop, Claude Code, Codex, OpenAI Responses

Write Support

Repos, URLs, YouTube, document uploads

Quick Start

Three steps to get an external AI client connected.

1. Generate an API key

Create a personal X Research API key from your profile settings.

2. Add the hosted MCP endpoint

Point your client at /api/mcp and send the X Research key in the Authorization header.

3. Start with policy and discovery tools

Call get_account_usage and get_repository_write_policy before write actions.

Client Setup

Reference snippets for Claude Desktop, Claude Code, OpenAI Codex, and OpenAI Responses.

Tool Catalog

What external clients can do

The hosted MCP exposes discovery, read, and write tools. Write tools are retry-safe and enforce the same server-side rules as the product.

DiscoveryRead Only

list_repositories

List repositories you can access.

get_account_usage

Check monthly upload and token usage.

get_repository_overview

Load repository metadata and topic map in one call.

get_repository_write_policy

Inspect upload permissions, limits, and supported file rules.

ReadRead Only

browse_resources

Browse resources by repository and optional type.

read_resource

Read the AI analysis and metadata for a specific resource.

search_resources

Search indexed content and get citations or ranked results.

WriteMutating

create_repository

Create a repository with retry-safe idempotency.

update_repository_metadata

Update repository name, description, visibility, and upload policy.

begin_repository_avatar_upload

Create a signed upload session for a repository avatar image.

complete_repository_avatar_upload

Finalize the uploaded repository avatar.

add_url_resource

Add a web page resource and queue processing.

add_youtube_resource

Add a YouTube resource and queue processing.

begin_document_upload

Create a signed upload session for a document.

complete_document_upload

Finalize the uploaded document and queue processing.

REST Example

Use the same external write service through REST if you do not want to call MCP directly.

curl -X POST "https://your-app-url.com/api/v1/repos" \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Macro Research",
    "description": "Tracking rates, inflation, and semis",
    "isPublic": false,
    "allowMemberUploads": true,
    "idempotencyKey": "repo-2026-03-07-macro-research"
  }'

Where to manage keys

Your API key lives in the profile settings area of the dashboard.

Use the profile panel to generate keys, revoke them, and copy ready-made setup snippets. This page is the canonical reference for capabilities and connection patterns.