Cursor MCP server for finding people

Before you start

You need an API key. Create one in the API page - it is shown once, so keep it somewhere before you close the tab. A new account comes with 500 free credits, which is enough to try this properly before deciding anything.

Where the config lives: ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.

Setting it up

1. 1

   Open the config

   Settings, then MCP, then Add new global MCP server. That opens the JSON file. Create it if it is not there.

2. 2

   Add the server

   Merge this into the file, keeping any servers you already have.

   ConfigCopy

   {
     "mcpServers": {
       "refolk": {
         "url": "https://www.refolk.ai/api/mcp",
         "headers": {
           "Authorization": "Bearer rfk_live_your_key_here"
         }
       }
     }
   }

3. 3

   Reload

   The server appears in the MCP settings pane with a green dot and its tools listed.

Check it worked. Open the chat in agent mode and ask for a shortlist. The tool call shows in the transcript.

What Cursor can do once it is connected

• refolk_search_people - Search for people in plain English (~10 reserved, reconciled down).
• refolk_filter_people - Search for people with exact filters (1 credit).
• refolk_plan_filters - Turn a description into a filter set (1 credit).
• refolk_credit_balance - Check the credit balance (free).

Two of the four spend credits, and both say so in the description the model reads, so it can tell you what a search will cost before it runs one. Nothing here writes: there is no tool that sends a message or changes your account.

The MCP overview has more on what to ask it, and the API reference documents the same searches as plain HTTP if you would rather call them from your own code.