mcp

Coinversaa Pulse is an MCP server that provides crypto intelligence for AI agents. It exposes a suite of Pulse tools for trader intelligence, trader profiles, cohort intelligence, and live market data. Once connected with a valid API key, you can query live market insights, cohort movements, and detailed trader analytics directly from MCP-compatible clients. The server is accessed via an MCP client by configuring the server under the mcpServers section in your client (for example Claude Desktop or Cursor) and pointing it at the @coinversaa/mcp-server package. Tools are organized into categories such as Pulse — Trader Intelligence, Pulse — Trader Profiles, Pulse — Cohort Intelligence, Market — Live Data, and Live — Real-Time Analytics, each with multiple specific endpoints.

Prerequisites:

• Node.js and npm installed on your machine
• An API key from Coinversaa (COINVERSAA_API_KEY)
• Optional: COINVERSAA_API_URL if not using production

Install and run (no cloning or building required):

1. Ensure Node.js and npm are installed
   • Check: node -v && npm -v
2. Run the MCP server via npx (no local install needed):
   • npx -y @coinversaa/mcp-server

Configuration in your MCP client:

• Claude Desktop: Edit claude_desktop_config.json to include: { "mcpServers": { "coinversaa": { "command": "npx", "args": ["-y", "@coinversaa/mcp-server"], "env": { "COINVERSAA_API_KEY": "cvsa_your_key_here" } } } }

• Cursor: Add to .cursor/mcp.json: { "mcpServers": { "coinversaa": { "command": "npx", "args": ["-y", "@coinversaa/mcp-server"], "env": { "COINVERSAA_API_KEY": "cvsa_your_key_here" } } } }

• Claude Code: claude mcp add coinversaa -- npx -y @coinversaa/mcp-server

Set the environment variable in your shell if needed: export COINVERSAA_API_KEY="cvsa_your_key_here"

Notes:

• No local repository clone is required; npx fetches and runs the package on demand.
• If you have a production API, set COINVERSAA_API_URL to the appropriate base URL.

Tips and common considerations:

• Always supply COINVERSAA_API_KEY; this is required for authentic API access.
• COINVERSAA_API_URL is optional and defaults to production or staging as indicated by the server; set it to production when available.
• If you encounter connectivity or API key issues, verify that the key matches the environment (staging vs production) and that your MCP client is correctly pointing to the server name (coinversaa).
• The MCP server exposes a broad set of tools; use the catalog in the README to decide which endpoints to invoke for trader stats, cohorts, market data, or live analytics.