The Model Context Protocol (MCP) is a standard that allows AI assistants — like Claude Code, Cursor, or VS Code — to securely interact with external tools and data sources. By connecting Spaace's MCP servers, your AI coding assistant can query live NFT data and execute trades while you build your app.
We offer two distinct MCP servers:
Spaace MCP: For NFT marketplace data, order books, and user portfolios.
Flip MCP: For launchpad pricing, bonding-curve liquidity, and trade simulation.
How to connect (Claude Code CLI — step by step)
Step 1 — Get a Session Token
Visit the MCP setup page on the Developer Portal and click Generate Token. Copy the token.
You can also generate one manually from your terminal:
macOS / Linux:
curl -s -X POST <https://mcp.spaace.io/mcp/session>
Windows PowerShell:
(Invoke-RestMethod -Method POST -Uri "<https://mcp.spaace.io/mcp/session>").token
(Note: For the Flip MCP, replace /mcp/session with /flip-mcp/session)
Step 2 — Register the MCP server
For Spaace MCP (macOS / Linux):
claude mcp add --transport http spaace <https://mcp.spaace.io/mcp> \\\\ --header "Authorization: Bearer YOUR_TOKEN"
For Flip MCP (macOS / Linux):
claude mcp add --transport http flip <https://mcp.spaace.io/flip-mcp> \\\\ --header "Authorization: Bearer YOUR_TOKEN"
Step 3 — Verify the connection
claude mcp list # spaace: <https://mcp.spaace.io/mcp> (HTTP) - Connected # flip: <https://mcp.spaace.io/flip-mcp> (HTTP) - Connected
Step 4 — Start the agent
Once running, provide your API key ("Set my Flip API key: flp_..." or "Set my API key: sk_...") and connect your wallet ("Connect my wallet") to unlock full execution capabilities.
Running both MCPs at the same time
You can run Spaace MCP and Flip MCP side by side. Each needs its own session token, but your wallet and API keys are shared — set once, available everywhere. If you use a .mcp.json config file, add both servers as separate entries:
{
"mcpServers": {
"spaace": {
"type": "http",
"url": "https://mcp.spaace.io/mcp",
"headers": {
"Authorization": "Bearer SPAACE_TOKEN"
}
},
"flip": {
"type": "http",
"url": "https://mcp.spaace.io/flip-mcp",
"headers": {
"Authorization": "Bearer FLIP_TOKEN"
}
}
}
}
Want to go further?
Check out the full technical documentation on the Spaace Developer Portal for the complete list of available tools, advanced configuration options, and troubleshooting guides.