MCP Tools

Molecule MCP Server Documentation

Overview

The Molecule MCP (Model Context Protocol) server enables AI assistants to access DeSci ecosystem data through natural language. Users can query AI assistants like Claude with questions like "What IPTs are available?" to receive real-time responses.

What is MCP?

Model Context Protocol is an open standard that allows AI assistants to utilize external tools, enabling access to current data from sources like Molecule's datasets.

MCP Server Functionality

The MCP server bridges AI assistants and Molecule Protocol data. It allows AI to fetch real data about IPTs, prices, and project activity, rather than just relying on pre-trained knowledge.

Example Interaction

• Query: "What's the price history for HAIR?"

• Process:

  1. AI Assistant interprets the request.

  2. Selects the appropriate tool.

  3. Calls the Molecule MCP server at https://molecule-mcp.vercel.app/mcp.

Data Sources

The MCP server pulls information from various resources like:

• Molecule API (GraphQL)

• Sanity CMS (Categories)

• GeckoTerminal (Price Data)

Quick Start Guide

Claude Desktop Integration

To enable Molecule tools in Claude Desktop:

• macOS: Add to ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: Add to %APPDATA%\Claude\claude_desktop_config.json

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

Restart Claude Desktop after saving.

Claude Code Integration

For CLI using Claude Code, add .mcp.json to your project root:

{
  "mcpServers": {
    "molecule": {
      "type": "url",
      "url": "https://molecule-mcp.vercel.app/mcp"
    }
  }
}

Other MCP Clients

Connect using Streamable HTTP transport:

import { experimental_createMCPClient as createMCPClient } from 'ai';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const client = await createMCPClient({
  transport: new StreamableHTTPClientTransport(
    new URL('https://molecule-mcp.vercel.app/mcp')
  )
});
const tools = await client.tools();

Example Conversations

• Ecosystem Overview: "What's happening in the Molecule ecosystem?"

• Project Deep Dive: "I'm interested in the HAIR project. What can you tell me?"

• Price Analysis: "How has VITA-FAST performed over the last month?"

Self-Hosting

For private deployments or custom configurations:

Requirements

• Node.js 18 or higher

• Vercel account or any Node.js platform

• Molecule API key

Deploy Steps

1. Request access to the MCP server source from the Molecule team (the repository is not publicly listed).

2. Install dependencies:

   pnpm install

3. Deploy to Vercel:

   vercel --prod

Add environment variables in Vercel under Settings.

Local Development

• Start with:

  vercel dev

Caching

The server caches upstream responses in Redis for a few minutes, enhancing performance and abiding by upstream limits — expect data freshness in the minutes range rather than real-time.

Rate Limits

The public endpoint is rate-limited. Deploy your own instance for heavy or latency-sensitive workloads.

Programmatic Integration

For AI applications requiring Molecule data, connect to the MCP endpoint directly. Any MCP-compatible client works — the example below uses the Vercel AI SDK's MCP client.

import { experimental_createMCPClient as createMCPClient, generateText } from 'ai';
import { openai } from '@ai-sdk/openai';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const mcpClient = await createMCPClient({
  transport: new StreamableHTTPClientTransport(
    new URL('https://molecule-mcp.vercel.app/mcp')
  )
});
const tools = await mcpClient.tools();

const result = await generateText({
  model: openai('gpt-4o'),
  tools,
  prompt: 'What IPTs are available in the longevity category?'
});

Troubleshooting

• Ensure configuration file syntax is valid.

• First request may be slower; consider using Redis for caching.

• Deploy your own instance if facing rate limit errors.

Resources

• Public Endpoint: https://molecule-mcp.vercel.app/mcp

• MCP Specification: https://modelcontextprotocol.io

• Source Code & API Key Request: Contact the Molecule team.