MCP Server

The Solenoid MCP (Model Context Protocol) server enables AI assistants like Claude Desktop and Cursor to interact directly with Solenoid APIs.

1.0 Remote MCP Server (Recommended)

The remote MCP server runs at https://api.solenoid.systems/mcp and requires no local installation. Authenticate with your API key via Bearer token.

1.1 Claude Desktop Setup

Add to your Claude Desktop config file:

Platform	Path
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

{
  "mcpServers": {
    "solenoid": {
      "type": "streamableHttp",
      "url": "https://api.solenoid.systems/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

1.2 Cursor Setup

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "solenoid": {
      "type": "streamableHttp",
      "url": "https://api.solenoid.systems/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

1.3 Tool Filtering

To enable only specific products, add a tools query parameter:

{
  "mcpServers": {
    "solenoid": {
      "type": "streamableHttp",
      "url": "https://api.solenoid.systems/mcp?tools=meter,gate,latch",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

2.0 One-Click Install (Claude Desktop)

Install Extension

Download the .mcpb file and drag it into Claude Desktop’s Settings window, or use Settings > Extensions > Install from file.

3.0 Available Tools

3.1 Meter

check_tenant_balance - Check a tenant meter balance
deduct_credits - Deduct from tenant meter
refill_credits - Add to tenant meter
reset_meter - Set tenant meter to exact value

3.2 Relay

schedule_webhook - Schedule delayed webhook delivery

3.3 Witness

init_witness_chain - Initialize a witness chain with an Ed25519 keypair
configure_witness_storage - Configure S3-compatible storage for receipt delivery
notarize_log - Notarize a JSON log entry, returns a signed receipt
verify_witness_receipt - Verify a receipt’s signature, content hash, and chain link
get_witness_pubkey - Retrieve the Ed25519 public key (JWK) for offline verification, by the chain_id witness init returns

3.4 Gate

list_flags - List feature flags
get_flag_config - Get all flag configs
check_flag - Check single flag state
set_flag - Create/update flag
delete_flag - Remove flag

3.6 Latch

acquire_lock - Get distributed lock
release_lock - Release lock
lock_status - Check lock state

3.7 Pulse

list_monitors - List uptime monitors
list_failing_monitors - Show failing monitors
create_monitor - Add monitor (with notification webhooks)
configure_monitor_notifications - Update notification config
delete_monitor - Remove monitor
check_monitor_now - Immediate check

3.8 Catch

create_catch_bucket - Create webhook bucket
list_catch_buckets - List all buckets
get_catch_bucket - Get bucket details
update_catch_bucket - Update bucket settings
delete_catch_bucket - Delete bucket
list_catch_events - List events in a bucket
get_catch_event - Get event details with payload

3.10 Key Management

create_api_key - Create new API key
rotate_api_key - Rotate key with grace period
list_api_keys - List all keys
revoke_api_key - Revoke a key

3.11 Utility (always available)

check_api_health - API status check
search_docs - Search documentation
list_docs - List doc topics

4.0 Authentication

Authenticate with your Solenoid API key using the Authorization: Bearer header. Get your key from the dashboard.