Search MCP - Ceramic

The Ceramic MCP Server enables AI systems to search the web through the Model Context Protocol.

Setup

Cursor
VS Code
Claude Code
Claude Desktop
Codex CLI

Install in Cursor

Click to install the Ceramic MCP server directly in Cursor.

Or add manually to your ~/.cursor/mcp.json:

{
  "mcpServers": {
    "ceramic": {
      "url": "https://mcp.ceramic.ai/mcp"
    }
  }
}

Install in VS Code

Click to install the Ceramic MCP server directly in VS Code.

Or add manually to your .vscode/mcp.json:

{
  "servers": {
    "ceramic": {
      "type": "http",
      "url": "https://mcp.ceramic.ai/mcp"
    }
  }
}

claude plugin marketplace add CeramicTeam/ceramic-claude-code-plugins

Install the plugin:

claude plugin install ceramic-search@ceramic-ai

Or within a session: /plugin install ceramic-search@ceramic-ai

Start a new Claude Code session. You’ll be prompted to authenticate via WorkOS OAuth — a browser window opens automatically.

Paid Plan (Pro / Team / Enterprise)
Free Plan

Connect directly from the Claude desktop app or claude.ai:

Go to Settings → Connectors
Click Add Custom Connector
Enter a name (e.g. ceramic)
Paste the MCP server URL: https://mcp.ceramic.ai/mcp
Click Add

Add to your Claude Desktop config file. Requires Node.js to be installed.

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

  {
    "mcpServers": {
      "ceramic": {
        "command": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://mcp.ceramic.ai/mcp"
        ]
      }
    }
  }

Restart Claude Desktop after saving the config.

codex plugin marketplace add CeramicTeam/ceramic-codex-plugins

Install the plugin:

Inside a Codex session, run /plugins, find ceramic-search under Ceramic AI Plugins, and select install. Codex opens a WorkOS OAuth page automatically.If the browser doesn’t open automatically, run this from a terminal outside Codex:

codex mcp login ceramic-search

Begin a new Codex session. The ceramic-search skill is active in every session and invokes automatically whenever the agent needs current web information.

Note: If your OAuth session expires, re-run the login command to re-authenticate.

Setup for additional clients can be found below.

ChatGPT

Note: MCP server support requires a ChatGPT Plus, Pro, or Team plan.From the ChatGPT desktop app or web browser:

Go to Settings → Apps
Click Advanced Settings
Enable Developer Mode
Click Create App
Paste the MCP server URL: https://mcp.ceramic.ai/mcp
Click Add

Gemini CLI

Add to your ~/.gemini/settings.json:

{
  "mcpServers": {
    "ceramic": {
      "httpUrl": "https://mcp.ceramic.ai/mcp"
    }
  }
}

Google Antigravity

In the Agent panel on the right side, click the three-dot menu
Select MCP Servers
Select Manage MCP Servers
Click View Raw config
Add the following:

{
  "mcpServers": {
    "ceramic": {
      "serverUrl": "https://mcp.ceramic.ai/mcp"
    }
  }
}

Kiro

Add to your ~/.kiro/settings/mcp.json:

{
  "mcpServers": {
    "ceramic": {
      "url": "https://mcp.ceramic.ai/mcp"
    }
  }
}

OpenCode

Add to your opencode.json:

{
  "mcp": {
    "ceramic": {
      "type": "remote",
      "url": "https://mcp.ceramic.ai/mcp",
      "enabled": true
    }
  }
}

Warp

Go to Settings → Agents → MCP Servers
Click +Add
Add the following:

{
  "ceramic": {
    "serverUrl": "https://mcp.ceramic.ai/mcp"
  }
}

Windsurf

Add to your ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "ceramic": {
      "serverUrl": "https://mcp.ceramic.ai/mcp"
    }
  }
}

Zed

Open your Zed settings (Zed → Settings → Open Settings JSON) and add:

{
  "context_servers": {
    "ceramic": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.ceramic.ai/mcp"]
    }
  }
}

Available Tools

`ceramic_search`

Searches the web and returns a ranked list of results. Agents get better results with specific terms than with conversational phrasing. See search best practices for more guidance.

​Setup

Install in Cursor

Install in VS Code

​Available Tools

​ceramic_search

Setup

Available Tools

`ceramic_search`