使用说明
risify-mcp
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.
