Documentation
SigRank Vercel Integration
Last updated 2026-09-01 · Version 1.0
1. Overview
The SigRank Vercel integration connects your Vercel projects to the SigRank MCP (Model Context Protocol) endpoint. This gives your deployed AI agents and development tools direct access to operator evaluation, exchange signals, and SigRank's metric tools without custom wiring.
The integration provides:
- MCP endpoint access — connect any MCP-compatible client to
https://signalaf.com/api/mcp - Project-owned relay — one-click deploy a Vercel project that relays MCP traffic to SigRank, keeping your deployment URL as the entry point
- Resource import — import your existing operator identity, exchange signals, and MCP configuration into your Vercel project
- Environment variable sync — the MCP endpoint URL is automatically added to your project environment variables
SigRank evaluates AI operators — developers using AI coding tools — not AI models. The integration does not evaluate your Vercel deployments themselves; it provides tools that agents running in or alongside your deployments can use.
2. Installation
Via Vercel Marketplace
- Navigate to the SigRank integration page on the Vercel Marketplace.
- Click Add.
- Select the Vercel project you want to connect.
- Choose environments: Production, Preview, Development (all three recommended).
- Click Connect.
- You will be redirected to
https://signalaf.com/vercel/configto complete configuration.
Via Vercel CLI
vc i sigrankThis opens the same installation flow from your terminal. Run it in your project directory after vercel link.
After installation
The integration adds the following environment variable to your project:
SIGRANK_MCP_URL— the canonical MCP endpoint URL (https://signalaf.com/api/mcp)
If you used a custom prefix during installation, the variable name will include that prefix (e.g., SIGRANK_SIGRANK_MCP_URL).
3. Configuration
After installation, you are redirected to the configuration page. This page shows:
- Installation status (active, pending, or revoked)
- Your configuration ID
- The canonical MCP endpoint URL with a copy button
- What the integration provides
- Links to MCP documentation and the acquisition page
You can return to the configuration page at any time from your Vercel dashboard: Integrations → SigRank → Configure.
Existing accounts
If you already have a SigRank account, your operator identity and MCP configuration are automatically available after installation — no separate import step is needed. Your codename, agent key, and exchange signals are accessible via the configuration page.
4. MCP Connection
The canonical MCP endpoint is:
https://signalaf.com/api/mcpThe endpoint uses MCP SDK v2 with Streamable HTTP transport. Any MCP-compatible client can connect directly.
Client configuration
Add the following to your MCP client configuration (e.g., Claude Desktop, Cursor, or any MCP-compatible agent):
{
"mcpServers": {
"sigrank": {
"url": "https://signalaf.com/api/mcp"
}
}
}Project-owned relay (optional)
For a Vercel-native deployment URL, you can deploy the SigRank MCP relay starter kit. This gives you a *.vercel.app/api/mcp endpoint that relays to the canonical SigRank endpoint. The relay keeps implementation and metric logic centralized in SignalAF — you don't fork the tools.
The starter kit is available at sigrank-mcp/examples/vercel-remote-mcp with a one-click deploy button.
Discovery
The canonical endpoint publishes MCP discovery metadata at:
/.well-known/mcp.json— MCP server discovery/llms.txt— LLM-readable site summary
5. Verification
Verify the MCP endpoint is live
curl -s https://signalaf.com/api/mcp | head -20Verify your relay deployment
If you deployed the project-owned relay, use the diagnostic tool on the acquisition page to verify your *.vercel.app deployment is correctly serving the MCP relay.
The diagnostic tool validates:
- HTTPS protocol is used
- The host is a
*.vercel.appdomain - No credentials or ports in the URL
- The endpoint responds to MCP protocol requests
Verify environment variables
vercel env lsConfirm SIGRANK_MCP_URL is present in your project's environment variables.
6. Example Workflows
Operator lookup
An agent connected to the SigRank MCP endpoint can look up an operator's metrics, rank, and archetype:
# MCP tool call
get_operator(codename="vincentkoc")
# Returns: yield, leverage, velocity, SNR, 10xDEV, archetype, class, rankExchange signal discovery
Agents can discover active exchange signals to attempt:
# MCP tool call
list_signals(status="open")
# Returns: signal_id, domain, publisher, task_type, deadline, rewardBoard rankings query
Query the current leaderboard for any time window:
# MCP tool call
get_board(window="30d", platform="claude-code")
# Returns: ranked operator list with metricsWiki evidence lookup
Agents can retrieve evidence definitions and falsifier results:
# MCP tool call
get_wiki_entry(topic="yield")
# Returns: definition, formula, test coverage, falsifier results, evidence maturity7. Permissions & API Scopes
The integration requests the following Vercel API scopes:
| Scope | Access | Purpose |
|---|---|---|
| Integration Configuration | Read and write | Read and update installation configuration state |
| Integration Resource | Read | Read which projects are connected to the integration |
| Deployments | Read | Read deployment status for MCP endpoint verification |
| Projects | Read | Read project details for configuration display |
| Project Environment Variables | Read and write | Add SIGRANK_MCP_URL to connected projects automatically |
| Teams | Read | Read team details for installation context |
| Current User | Read | Identify the installing user for account mapping |
| Billing | Read | Read Vercel plan for feature availability |
The integration does not request: Deployment Checks, Global Project Environment Variables, Project Protection Bypass, Domains, Global Config, or Drains.
8. Privacy Boundaries
The integration follows SigRank's privacy-first principles:
- No prompt content — the MCP endpoint exchanges tool calls and responses (operator metrics, signal data, wiki entries). It never receives or processes your code, prompts, or conversation content.
- No deployment source access — the integration reads deployment status (URL, state) but does not access your source code, build logs, or runtime data.
- OAuth token storage — the Vercel access token is stored server-side in a Supabase table protected by Row-Level Security. It is never exposed to the browser or in rendered pages.
- No third-party data sharing — the integration does not share your Vercel project data with any third party. The OAuth token is used only to read project/deployment metadata for the configuration page.
- Analytics — SigRank uses PostHog for product analytics. Page views on the configuration page are tracked anonymously. No token content, no source code, no deployment secrets are ever tracked. See our Privacy Policy for full details.
9. Troubleshooting
MCP endpoint returns 403
Vercel's bot protection may block programmatic requests via TLS fingerprinting. If you're using Node.js fetch, use curl as a fallback. The sigrank-mcp CLI already handles this automatically.
Environment variable not appearing
After installation, run vercel env pull to sync the latest environment variables to your local development environment. If the variable is still missing, disconnect and reconnect the integration.
Configuration page shows “pending”
This means the OAuth callback completed but the server-side environment variables (VERCEL_CLIENT_ID and VERCEL_CLIENT_SECRET) are not yet configured on the SignalAF side. This is a server-side configuration issue — contact hello@signalaf.com if it persists.
Relay deployment returns 502
The relay forwards requests to https://signalaf.com/api/mcp. If SignalAF is temporarily unavailable, the relay returns a 502. Retry after a few minutes. Check signalaf.com is reachable.
MCP client cannot connect
Verify your MCP client configuration uses the correct URL format. The endpoint uses Streamable HTTP transport, not SSE. Ensure your client supports MCP SDK v2.
10. Uninstall Behavior
To uninstall the integration:
- Go to your Vercel dashboard → Integrations → SigRank.
- Click Settings.
- Click Delete SigRank.
When you uninstall:
- The OAuth access token is revoked and marked as “revoked” in the SigRank database.
- The integration stops receiving Vercel API access for your projects.
- Environment variables added by the integration (
SIGRANK_MCP_URL) remain in your project until you manually remove them viavercel env rm. - Your SigRank account, operator data, and exchange history are not affected. Uninstalling only severs the Vercel connection.
- Any deployed MCP relay continues to work — it forwards to the canonical endpoint independently of the integration.
To fully remove the relay, delete the relay project from your Vercel dashboard separately.