url-ingest Integrate

Attach Agents and backend code to url-ingest via MCP or REST.

MCP (recommended for Agents)

url-ingest mounts at /mcp/url-ingest. Every tool is prefixed ctxkit_ingest_* so it's clear what the Agent is calling.

{
  "mcpServers": {
    "ctxkit-url-ingest": {
      "type": "http",
      "url": "https://api.ctxkit.com/mcp/url-ingest",
      "headers": {
        "X-API-Key": "ctxk_..."
      }
    }
  }
}

Tools

• ctxkit_ingest_url — submit a URL for processing.
• ctxkit_ingest_get_job — poll job status.
• ctxkit_ingest_get_resource — metadata + TOC + image preview.
• ctxkit_ingest_list_resources — browse processed content.
• ctxkit_ingest_list_images — paginated images with signed URLs.
• ctxkit_ingest_read — progressive-disclosure read (navigate by heading).
• ctxkit_ingest_search — semantic search across resources.

REST

Prefer REST for backend automation — e.g. ingesting URLs from a cron job. All paths are project-scoped:

POST /api/v1/projects/<pid>/url-ingest/ingest
GET  /api/v1/projects/<pid>/url-ingest/jobs/<jid>
POST /api/v1/projects/<pid>/url-ingest/search

The per-project Integrate tab in the dashboard generates ready-to-paste configs for Cursor, VS Code, Claude Code CLI, and Claude Desktop (via mcp-remote).