Skip to main content

Proxy

MCP Rank provides two types of proxy access:
  1. OAuth Proxy - Call Google APIs (Gmail, Calendar, Drive) on behalf of users
  2. MCP Server Proxy - Call MCP server tools through MCP Rank
Both proxies handle authentication, rate limiting, and error normalization for you.

OAuth Proxy (Google APIs)

Make API calls to Google services using stored OAuth tokens. You never see the tokens - just provide the user’s MIT.

Prerequisites

Before making proxy requests, ensure:
  1. Client is initialized with user_id
  2. User has connected Google (via JIT auth or manual flow)

Check Access

Before making requests, verify the user has connected the provider:

GET Requests

POST Requests

PUT/PATCH/DELETE

Google API Examples

Gmail

Calendar

Drive


MCP Server Proxy

Call MCP server tools through MCP Rank. This abstracts away:
  • Transport: SSE responses are buffered to JSON
  • Server URLs: Just use the server ID
  • Authentication: Server-specific auth handled for you

Get Server Info

List Server Tools

Call a Tool

Generic JSON-RPC Call

For full control, use the generic call endpoint:

Available MCP Methods


Error Handling

Rate Limits

Proxy requests are subject to:
  1. MCP Rank rate limits (based on your API key tier)
  2. Provider rate limits (Google API quotas, MCP server limits)
Handle rate limits gracefully: