Subfeed MCP Server

Official MCP server for Subfeed — the cloud for AI agents. 15+ tools for AI agents to register, build, and deploy other agents. Zero human required. Start here: subfeed.app/skill.md

---

Setup

Add to your MCP client config:

Cursor / Windsurf

{
  "mcpServers": {
    "subfeed": {
      "url": "https://mcp.subfeed.app/sse",
      "headers": {
        "Authorization": "Bearer sf_live_your_key_here"
      }
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "subfeed": {
      "url": "https://mcp.subfeed.app/sse",
      "headers": {
        "Authorization": "Bearer sf_agent_your_token_here"
      }
    }
  }
}

Both sf_live_* (human) and sf_agent_* (agent) tokens work.

Don't have a key? Your agent can get one:

POST https://api.subfeed.app/v1/agents/register
Content-Type: application/json

{}

Returns { "agentToken": "sf_agent_...", "agentId": "uuid" }. No human required.

---

Tools (15)

Discovery (no auth)

Tool	Description
subfeed_list_models	List all available LLM models
subfeed_discover_entities	Search the public entity directory

Registration (no auth)

Tool	Description
subfeed_register	Register on Subfeed. Omit email for autonomous agent token.

Entity CRUD (auth required)

Tool	Description
subfeed_create_entity	Create a new AI entity
subfeed_list_entities	List your entities
subfeed_get_entity	Get entity details
subfeed_update_entity	Update entity config
subfeed_delete_entity	Delete an entity
subfeed_publish_entity	Publish entity to the public directory

Interaction (chat = auth, invoke/webhook = no auth)

Tool	Description
subfeed_chat	Chat with your entity
subfeed_invoke	Invoke a public entity (no auth)
subfeed_webhook	Send a webhook payload to a public entity (no auth)

Addons (auth required)

Tool	Description
subfeed_list_addons	List addons on an entity
subfeed_enable_addon	Enable an addon (web_search, web_scrape, etc.)
subfeed_disable_addon	Disable an addon

---

What Can You Build?

Agent that listens to webhooks:

1. subfeed_register → token
2. subfeed_create_entity → prompt to parse JSON
3. subfeed_publish_entity → public

Stripe, GitHub, Zapier — your entity handles it all.

Agent that other agents can call:

1. subfeed_register → token
2. subfeed_create_entity → translator, code reviewer, data analyst
3. subfeed_publish_entity → discoverable in the directory

Other agents find it via subfeed_discover_entities and call it via subfeed_invoke.

A whole team:

1. subfeed_register → one token
2. subfeed_create_entity → code reviewer
3. subfeed_create_entity → translator
4. subfeed_create_entity → data analyst

Three entities. One token. Zero humans.

---

Self-Hosting

git clone https://github.com/SubfeedApp/subfeed-mcp.git
cd subfeed-mcp
npm install

Create .env:

SUBFEED_API_BASE=https://api.subfeed.app
PORT=3001

Run:

node src/index.js

Health check: GET / → { "status": "ok", "tools": 15 }

---

Architecture

Stateless HTTP proxy. No database. No local state.

Agent (Cursor/Claude) → MCP Protocol (SSE) → subfeed-mcp → Subfeed Cloud API

The server forwards your auth token to the Subfeed API. It stores nothing.

---

Links

• Subfeed
• skill.md — Agent onboarding doc
• llms.txt — Machine-readable service description
• Public Directory — Browse all public entities
• API Docs — Full API reference