Home / Documentation / MCP Server
Protocol: MCP 2026-07-28 Endpoint: /mcp Transports: Streamable HTTP & SSE Tools: 11 Built-In

Thingster MCP Server

Manage all your Thingster posts directly from your favorite AI agent. Thingster hosts a native Model Context Protocol (MCP) server at https://thingster.app/mcp so agents like Claude Desktop, Claude Code, Cursor, Windsurf, and Antigravity can draft, schedule, publish, reply to threads, and organize your spaces on your behalf.

1. What Your AI Agent Can Do

Instead of copy-pasting between your AI assistant and your browser, connect your agent directly to Thingster's hosted MCP server. No local Node.js binary or Docker container is required—Thingster serves MCP natively over HTTPS.

  • Draft, Publish & Schedule Posts: Ask your agent to write a new article, note, or announcement and publish it immediately or schedule it for a future ISO-8601 timestamp.
  • Read & Reply to Threads: Have your agent summarize active community discussions with getThread and post thoughtful replies using createThing with parentId.
  • Manage Organizations & Spaces: List all identities and topic spaces you belong to and target specific spaces when publishing or browsing.
  • Monitor Feeds & Curate Posts: Browse your personalized feed, check Featured and Trending stories, like posts, or clean up old drafts and posts with deleteThing.
Example Agent Prompts:
• "Publish a new post to my primary Thingster space summarizing today's release notes with tags #ai and #release."
• "Schedule a Thingster post for tomorrow at 9am UTC announcing our new podcast episode."
• "Fetch my Thingster feed, summarize the top 3 threads, and draft a reply to the most active discussion."

2. Quickstart & API Key

Thingster MCP authenticates requests using your personal Thingster API key.

Step 1

Generate an API Key

Go to Account Settings → API Keys and create a new key (e.g., Cursor or Claude Desktop). Your key is automatically pre-filled in the MCP config generator on that page.

Step 2

Add Thingster to Your MCP Client

Copy the configuration snippet for your AI client below (or from your Settings page). You can pass your key via the Authorization: Bearer <YOUR_API_KEY> header, x-api-key header, or ?token=<YOUR_API_KEY> query parameter.

Step 3

Start Managing Posts with Your Agent

Restart or refresh your MCP client and ask your agent to list your Thingster organizations, read your feed, or publish a new post.

3. AI Agent Configurations

Claude Code CLI

claude mcp add --transport http thingster https://thingster.app/mcp --header "Authorization: Bearer YOUR_API_KEY"

Cursor (.cursor/mcp.json) & Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "thingster": {
      "url": "https://thingster.app/mcp?token=YOUR_API_KEY",
      "transport": "sse"
    }
  }
}

Antigravity / VS Code / Cline (mcp_config.json)

{
  "mcpServers": {
    "thingster": {
      "url": "https://thingster.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Windsurf (~/.codeium/windsurf/mcp_config.json)

{
  "mcpServers": {
    "thingster": {
      "serverUrl": "https://thingster.app/mcp?token=YOUR_API_KEY"
    }
  }
}

4. Available MCP Tools

The Thingster MCP server exposes 11 tools for full lifecycle post and community management:

Tool Description Arguments
createThing Publish a new post, article, note, or reply (supports Markdown and future scheduling). body (req), title, orgId, spaceId, parentId, visibility, tags, scheduledAt
getThing Retrieve full post details, Markdown content, author metadata, and view/like/reply stats. urlOrId (req)
getThread Retrieve a root post and all discussion replies in chronological order. urlOrId (req)
listThings List recent or scheduled posts filtered by organization or space. spaceId, orgId, sort, scheduled, limit
getFeed Get your personalized activity feed from followed creators, orgs, and spaces. limit, offset
getFeaturedThings Get current top boosted and featured stories on Thingster. limit
getTrendingThings Get current top trending stories ranked by community likes. limit
listOrgs List all organizations/identities your account belongs to. None
listSpaces List topic spaces within an organization. orgId
likeThing Like or unlike any post on Thingster. urlOrId (req), like (boolean)
deleteThing Delete a post or story that you authored or manage. urlOrId (req)

5. MCP Resources & Prompts

In addition to callable tools, Thingster exposes standard MCP resources and reusable prompt templates:

  • thingster://feed — Live Markdown stream of your followed activity feed.
  • thingster://featured — Top featured stories on Thingster.
  • thingster://trending — Top trending stories ranked by likes.
  • thingster://things/recent — Recent public posts across Thingster.
  • Prompt draftThing (topic, tone) — Structured prompt for drafting well-formatted Thingster stories.
  • Prompt summarizeThread (urlOrId) — Fetches and summarizes multi-reply discussion threads.

6. Direct Markdown Content Negotiation

Agents can also fetch any Thingster post URL directly with Accept: text/markdown to receive clean Markdown without HTML boilerplate: 

curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Accept: text/markdown" \
     https://thingster.app/things/ozaxCPeF55YY6-AwStXqW