Masheev MCP Server

A Model Context Protocol (MCP) server that gives AI assistants (Claude, Cursor, etc.) structured access to Masheev APIs. The server dynamically discovers endpoints from your OpenAPI specification, so no manual endpoint mapping is required.

Installation

npm install -g @masheev/mcp

Or run directly with npx:

npx @masheev/mcp

Configuration

Claude Desktop

Add to your Claude Desktop configuration (~/.claude_desktop_config.json):

{
  "mcpServers": {
    "masheev": {
      "command": "npx",
      "args": ["@masheev/mcp"],
      "env": {
        "MASHEEV_API_BASE_URL": "https://api.masheev.com",
        "MASHEEV_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP configuration:

{
  "mcpServers": {
    "masheev": {
      "command": "masheev-mcp",
      "env": {
        "MASHEEV_API_BASE_URL": "https://api.masheev.com",
        "MASHEEV_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | MASHEEV_API_BASE_URL | No | http://localhost:3015 | Base URL of the Masheev API | | MASHEEV_API_TOKEN | No | — | API token for authenticated requests | | API_PORT | No | 3015 | Port override for local development |

Available Tools

list_api_endpoints

Search and discover available API endpoints.

Parameters:

• query (optional) — Search by summary, description, tags, or path
• category (optional) — Filter by category (use get_api_categories first)
• tag (optional) — Filter by tag
• requiresAuth (optional) — Filter by authentication requirement

get_api_endpoint_schema

Get detailed schema and documentation for a specific endpoint.

Parameters:

• endpointId (required) — Endpoint ID from list_api_endpoints

execute_api_endpoint

Execute an API endpoint with parameters.

Parameters:

• endpointId (required) — Endpoint ID to execute
• parameters (optional) — Object of parameters to pass

get_api_categories

Get all available API categories with their descriptions. No parameters required.

Local Development

# Start the Masheev API server (port 3015)
pnpm api:dev

# In another terminal, start the MCP server in watch mode
pnpm --filter @masheev/mcp dev

License

MIT

Links

• Masheev
• Repository
• Model Context Protocol