Home / Docs / MCP Server

MCP Server

Compare MCP clients and connect them to Plushcap with a Bearer token or OAuth.

MCP Server

Connect an MCP-compatible AI client to Plushcap to query company engineering blogs, YouTube metrics, Hacker News posts, and industry trends.

Active Accelerate and Lead accounts also receive premium read-only tools for trend reports, competitive spaces and comparison dashboards, and raw monthly and yearly trend metrics:

  • list_trend_reports and get_trend_report
  • list_competitive_spaces and get_competitive_space
  • get_competitive_space_comparison and compare_companies
  • get_monthly_trend_metrics and get_yearly_trend_metrics

Server URL:

https://mcp.plushcap.com/mcp

Choose an authentication method

Plushcap MCP supports two authentication methods:

  • Bearer token — recommended for ongoing use. Create a Plushcap API key from your account and configure the client to send it in the Authorization header. API keys do not expire by default; they remain active until you regenerate, delete, or explicitly expire them.
  • OAuth — fastest to get started. Authorize the client in your browser. Plushcap OAuth access tokens last one hour. Clients that request offline_access receive a rotating refresh token with a 90-day lifetime, but you may need to authorize again when a refresh credential expires, is lost, or is not refreshed correctly by the client.

MCP API-key authentication uses:

Authorization: Bearer your-api-key-here

This differs from the Plushcap REST API, which uses X-API-Key. Prefer an environment variable or a client's secret field over putting the key directly in a configuration file. Never commit the key or paste it into a chat prompt. Regenerate it from your account if it is exposed.

Compare MCP clients

Client MCP support OAuth Bearer token Recommended setup
ChatGPT Web Supported Yes No custom API keys OAuth
ChatGPT Desktop Supported Yes Yes Bearer token
Claude Desktop Supported Yes No direct header setting OAuth
Claude Web Supported Yes No direct header setting OAuth
Claude Code Supported Yes Yes Bearer token
Codex CLI Supported Yes Yes Bearer token
Antigravity CLI Supported Yes Yes Bearer token
Devin Supported Yes Yes Bearer token
Gemini Web Limited to Gemini Spark Yes No documented header setting OAuth
Gemini Desktop No direct setup documented No No Use another client
LM Studio Supported Yes Yes Bearer token

If your client supports both methods, start with OAuth for a quick test and switch to a Bearer token for a connection that does not depend on the client's OAuth refresh behavior.

Verify the connection

After setup, ask your client:

Use Plushcap to list the latest developer industry trend reports.

Health Check

Confirm the MCP service is online at:

https://mcp.plushcap.com/health

Last verified: July 29, 2026.

X Content Research Tools

The authenticated server also registers list_company_x_accounts, get_company_x_posts, get_company_x_post, get_company_x_summary, find_high_engagement_x_posts, research_company_x_content, and get_global_hackernews_posts. These tools require at least Free access and forward only validated read parameters. The composite research tool makes one REST call and returns evidence; the calling model is responsible for critiques and recommendations.

Global Content Search and YouTube Research

Use search_youtube_videos and search_x_posts for intersecting multi-company searches. Use research_company_youtube_content for one evidence-only composite call; the calling model owns all advice.