README.md

Website | Documentation | X (Twitter) | Support

Superface MCP Server

Use Superface tools via Model Context Protocol.

Setup

Adding tools & obtaining API Key

1. Go to the Superface dashboard
2. Select and add the tools you want to use with MCP Server
3. Copy your API key in the dashboard

You'll need this API key for the MCP Server configuration.

Usage with Claude Desktop

1. Open Claude Desktop
2. Go to Settings (click on your profile picture or ⌘ + ,)
3. Open "Developer" tab
4. Click "Edit Config"
5. Open claude_desktop_config.json file
6. Add the following configuration:

NPX

{
  "mcpServers": {
    "superface": {
      "command": "npx",
      "args": [
        "-y",
        "@superfaceai/mcp"
      ],
      "env": {
        "SUPERFACE_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Docker

{
  "mcpServers": {
    "superface": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SUPERFACE_API_KEY",
        "mcp/superface"
      ],
      "env": {
        "SUPERFACE_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Build

Docker build:

docker build -t mcp/superface .

License

This project is licensed under the MIT license. See the LICENSE file for details.