Home / Docs / MCP Server

MCP Server

Connect Plushcap to Claude, Codex, and other MCP clients.

MCP Server

The Plushcap MCP server lets compatible AI clients query Plushcap data about company engineering blogs, YouTube metrics, Hacker News posts, and industry trends.

Server URL:

https://mcp.plushcap.com

Authentication

Plushcap MCP supports two authentication methods:

  • OAuth, for MCP clients that support remote OAuth authorization.
  • Plushcap API keys, sent as a bearer token.

For API key access, create or copy your Plushcap API key from your account and send it as:

Authorization: Bearer your-api-key-here

ChatGPT Web

ChatGPT can connect to Plushcap as a custom MCP app from ChatGPT web. OpenAI's current setup flow uses developer mode and a remote HTTPS MCP server.

  1. Open ChatGPT in your browser.
  2. Go to Settings → Apps & Connectors → Advanced settings.
  3. Enable Developer mode, if it is available for your account or workspace.
  4. Go to Settings → Apps & Connectors and choose Create.
  5. Use these connector details:
Name: Plushcap
Description: Query Plushcap data about developer companies, content, YouTube, Hacker News, and trends.
URL: https://mcp.plushcap.com
Authentication: OAuth

After creating the app, ChatGPT should show the tools exposed by Plushcap. Open a new chat, select Plushcap from the tools menu, and complete the Plushcap OAuth authorization flow if prompted.

For Business, Enterprise, or Edu workspaces, your admin may need to enable developer mode, approve the app, or publish it before other workspace members can use it.

ChatGPT Desktop App

Use ChatGPT web to create and authorize the Plushcap MCP app first. OpenAI's current MCP app creation and developer mode docs are web-focused.

After Plushcap is connected in ChatGPT web, open the ChatGPT desktop app and check the tools or apps menu in a new chat. If Plushcap appears there, select it and start asking questions that use Plushcap data. If it does not appear, use ChatGPT web for Plushcap MCP access until custom MCP apps are available in your desktop app version.

Claude

For Claude Code, add Plushcap from the project where you want to use it:

claude mcp add --transport http plushcap https://mcp.plushcap.com
claude mcp list

To make it available across all Claude Code projects on your machine, add --scope user:

claude mcp add --transport http --scope user plushcap https://mcp.plushcap.com

In Claude Code, run /mcp to authenticate and confirm the server is connected. If your Claude client asks for a bearer token instead, use your Plushcap API key.

Codex

Add Plushcap with the Codex CLI:

codex mcp add plushcap --url https://mcp.plushcap.com
codex mcp login plushcap
codex mcp list

If codex mcp login plushcap says OAuth is only supported for streamable HTTP servers, remove and re-add the server with --url. Without --url, Codex stores https://mcp.plushcap.com as a stdio command instead of a remote HTTP MCP URL.

For API-key authentication, set an environment variable with your Plushcap API key and reference it from ~/.codex/config.toml:

[mcp_servers.plushcap]
url = "https://mcp.plushcap.com"
bearer_token_env_var = "PLUSHCAP_API_KEY"

Restart Codex after updating the configuration so the new server is loaded. In the Codex TUI, use /mcp to see active MCP servers.

Other MCP Clients

Use the same server URL with any client that supports streamable HTTP MCP:

https://mcp.plushcap.com

If the client supports OAuth, authorize through Plushcap. Otherwise, configure the client to send your Plushcap API key as an Authorization: Bearer token.

Client Documentation

Health Check

You can confirm the MCP service is online at:

https://mcp.plushcap.com/health