Shape MCP Server

Model Context Protocol (MCP) server for Shape, built with xmcp. This server provides AI assistants access to Shape’s onchain data: gasback distribution, collections analytics, stack users & more.

Contributions are welcome! Fork and add your own tools, feel free to submit a PR.

Check our docs about how to build AI on Shape: https://docs.shape.network/building-on-shape/ai

Features

Organized by functionality for easy extension:

• Gasback Analytics - Track creator earnings, top performers, and simulate gasback earned
• NFT Analysis - Collections and ownership
• Stack Achievements - Monitor user progress in Shape’s Stack ecosystem
• Network Monitoring - Chain health, metrics, RPC URLs, etc
• AI Ready - Tools are optimized for agent chaining and automation
• Caching - Optional Redis for snappier responses & less load on RPCs, no lock-in required

Available Tools

Network Tools (/tools/network/)

getChainStatus

Monitor Shape’s network: RPC health, gas prices, block times, etc.

Example prompt: “current shape status? gas prices looking mint-friendly?”

NFT Tools (/tools/nft/)

getCollectionAnalytics

Collection stats: supply, owners, sample NFTs, floors, etc.

Example prompt: “what’s the vibe on collection 0x567…abc? floor price and top holders?”

getShapeNft

List NFTs for an address, with metadata.

Example prompt: “what NFTs does 0xabcd…123 hold on shape?”

Gasback Tools (/tools/gasback/)

getShapeCreatorAnalytics

Shape builder/creator deep dive: earnings, tokens, withdrawals, etc.

Example prompt: “analyze creator 0xabcd…123’s gasback and compare to top earners. any tips?”

getTopShapeCreators

Top creators by gasback earned & tx.

Example prompt: “who are shape’s top 10 gasback earners?”

simulateGasbackRewards

Get gasback rough estimates.

Example prompt: “simulate 50 txs/day at 50k gas—earnings over 3 months? wen lambo?”

🏗️ Stack Tools (/tools/stack/)

getStackAchievements

User medals by tier, total count, etc.

Example prompt: “what’s 0xghi…123’s stack status? gold medals?”

Quick Test (No Setup Required)

Want to try the MCP server without local setup? Point directly to our deployed instance:

{
  "mcpServers": {
    "shape-mcp": {
      "url": "https://shape-mcp-server.vercel.app/mcp"
    }
  }
}

Note: This deployed version is rate limited and is intended for testing/sandbox use only. For production AI applications, we recommend self-hosting your own instance following the setup instructions above.

Prerequisites

• Alchemy API key for NFT queries (get one here)
• MCP client like Cursor IDE, Claude Desktop or your AI client of choice
• Optional: Redis for caching (speeds up RPC-heavy tools)

Setup

1. Environment Configuration