RankedIn

Documentation

Everything you need to integrate RankedIn with Claude, Cursor, and other AI tools.

Getting StartedMCP ServerREST APITools ReferenceOAuth 2.0Troubleshooting

Getting Started

  1. Sign up at rankedin.app
  2. Export your LinkedIn data — LinkedIn → Settings & Privacy → Data Privacy → Get a copy of your data → Request archive
  3. Upload the ZIP to RankedIn — analysis completes in ~30 seconds
  4. Generate an API key at Dashboard → Settings
  5. Connect to Claude using the MCP server or REST API below

MCP Server

RankedIn exposes a Model Context Protocol server at https://rankedin.app/api/mcp. This lets Claude, Cursor, Windsurf, and other MCP-compatible clients answer career questions using your own LinkedIn data.

Claude.ai (OAuth — recommended)

Click Add Integration in Claude.ai settings and enter:

https://rankedin.app/api/mcp

You'll be prompted to sign in to RankedIn via OAuth — no API key needed.

Claude Desktop (API key)

Install mcp-remote then add to claude_desktop_config.json:

{
  "mcpServers": {
    "rankedin": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://rankedin.app/api/mcp",
        "--header",
        "Authorization: Bearer rkin_YOUR_API_KEY"
      ]
    }
  }
}
Cursor / Windsurf (API key)
{
  "mcpServers": {
    "rankedin": {
      "url": "https://rankedin.app/api/mcp",
      "headers": { "Authorization": "Bearer rkin_YOUR_API_KEY" }
    }
  }
}

Tools Reference

All tools are read-only (readOnlyHint: true). Each accepts an optional analysis_id — omit to use the most recent analysis.

get_my_scores

Returns overall score (0–100) and 8 dimension scores: Network, Engagement, Credibility, Outreach, Content, Career, Learning, Influence.

get_network_summary

Returns total connections, growth rate, avg new connections/month, reactions, comments, recommendations given/received, and account age.

get_peer_comparison

Returns global and peer-group percentile rankings per dimension, compared against users with the same job level and industry.

get_connection_insights

Returns silent quitters (people who disconnected since the last analysis) and new connections, with names and companies.

get_improvement_tips

Returns AI-generated summary, strengths, areas for improvement, and actionable recommendations from Gemini AI.

get_career_timeline

Returns career pattern, target role, skill gaps, next steps, peer career pathways, and job search insights derived from your LinkedIn Jobs folder.

REST API

All endpoints require Authorization: Bearer rkin_YOUR_API_KEY. Full OpenAPI spec available at rankedin.app/openapi.json.

GET /api/v1/me
GET /api/v1/analyses
GET /api/v1/analyses/{id}/scores
GET /api/v1/analyses/{id}/network
GET /api/v1/analyses/{id}/insights
GET /api/v1/analyses/{id}/benchmarks
GET /api/v1/analyses/{id}/career
GET /api/v1/analyses/{id}/connection-changes

OAuth 2.0

RankedIn supports the OAuth 2.0 Authorization Code flow for integrations like Claude.ai and ChatGPT Custom GPTs.

Authorization URLhttps://rankedin.app/oauth/authorize
Token URLhttps://rankedin.app/api/oauth/token
Scoperead
Token formatBearer rkin_...

To register a new OAuth client, contact support@rankedin.app.

Troubleshooting

Claude says "No completed analyses found"

Upload a LinkedIn export at rankedin.app/dashboard. Make sure the analysis status is "completed" before querying.

Career intelligence returns "not available"

Re-export from LinkedIn and include the Jobs/ folder (job applications, saved jobs). This data is only present in the full archive export.

Many metrics show N/A

Request the full LinkedIn data archive (not the quick export). The full archive includes Reactions.csv, Comments.csv, Recommendations.csv, and Registration.csv which populate the remaining metrics.

Claude Desktop: MCP not connecting

Claude Desktop does not support the url/headers format. Install mcp-remote (npm install -g mcp-remote) and use the command/args config shown above.

API returns 401 Unauthorized

Check that your API key starts with rkin_ and is passed as: Authorization: Bearer rkin_YOUR_KEY

HomePrivacy PolicyTerms of Servicesupport@rankedin.app