Risify Mcp Public

A Model Context Protocol (MCP) server for the Risify GraphQL API. Helps AI assistants search the schema and write correct GraphQL queries and mutations.

Install

macOS / Linux

curl -sL https://raw.githubusercontent.com/analyzify/risify-mcp-public/main/install.sh | sh

This auto-detects your OS and architecture, downloads the latest binary, and installs it to /usr/local/bin.

Windows (PowerShell)

irm https://raw.githubusercontent.com/analyzify/risify-mcp-public/main/install.ps1 | iex

This downloads the latest Windows binary and installs it to %LOCALAPPDATA%\risify-mcp, automatically adding it to your PATH.

Supported platforms: macOS (Intel/Apple Silicon), Linux (amd64/arm64), Windows (amd64/arm64)

Manual install

Download the binary for your platform from the Releases page, extract it, and place it somewhere in your $PATH.

Verify

risify-mcp version

On Windows, you can also use: risify-mcp.exe version

Configuration

Add to your MCP client configuration:

Claude Code (.claude/settings.json):

{
  "mcpServers": {
    "risify": {
      "command": "risify-mcp",
      "args": ["serve"],
      "env": {
        "RISIFY_USER_ID": "your-user-id",
        "RISIFY_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "risify": {
      "command": "risify-mcp",
      "args": ["serve"],
      "env": {
        "RISIFY_USER_ID": "your-user-id",
        "RISIFY_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor / VS Code (MCP settings):

{
  "risify": {
    "command": "risify-mcp",
    "args": ["serve"],
    "env": {
      "RISIFY_USER_ID": "your-user-id",
      "RISIFY_API_KEY": "your-api-key"
    }
  }
}

Without env vars, the server works in schema-only mode (search + full schema tools).

Environment Variables

Variable	Required	Default	Description
RISIFY_USER_ID	yes	—	Your Risify user ID
RISIFY_API_KEY	yes	—	Your Risify API key
RISIFY_API_URL	no	Production API	Main Risify GraphQL endpoint (override for custom environments)
RISIFY_REPORT_API_URL	no	Production GSC analytics endpoint	GraphQL endpoint for Search Console analytics. Used when service: "gsc" is requested.
RISIFY_KEYWORD_API_URL	no	Production keyword tracking endpoint	GraphQL endpoint for keyword tracking. Used when service: "keyword" is requested.

Testing

After installation, verify everything works:

1. Public route (no auth needed)

risify-mcp query '{ ping }'

Expected:

{
  "data": {
    "ping": "pong"
  }
}

2. Authenticated route

Set your credentials and test the me query:

RISIFY_USER_ID="your-user-id" \
RISIFY_API_KEY="your-api-key" \
  risify-mcp query '{ me { id email firstName lastName shopName } }'

Expected (with valid credentials):

{
  "data": {
    "me": {
      "id": "...",
      "email": "...",
      "firstName": "...",
      "lastName": "...",
      "shopName": "..."
    }
  }
}

3. Schema search (offline)

risify-mcp search audit
risify-mcp search product --filter queries
risify-mcp search recommendation --filter mutations

CLI Commands

risify-mcp serve                                    # Start MCP server (stdio)
risify-mcp serve --transport sse --addr :8080       # Start MCP server (SSE HTTP)
risify-mcp search audit                             # Search schema for "audit"
risify-mcp search product --filter queries          # Search queries only
risify-mcp query '{ ping }'                         # Execute a query
risify-mcp version                                  # Print version

MCP Tools

Tool	Description
introspect_schema	Search the schema for types, queries, and mutations by name
graphql_schema_full	Returns the complete schema in SDL format
execute_graphql	Execute a GraphQL query/mutation against the live API

Uninstall

macOS / Linux

sudo rm /usr/local/bin/risify-mcp

Windows (PowerShell)

Remove-Item "$env:LOCALAPPDATA\risify-mcp" -Recurse -Force

After removal, you may also want to remove %LOCALAPPDATA%\risify-mcp from your PATH environment variable via System Settings.