VS Code 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: .vscode/mcp.json in the workspace, or the user-level MCP settings.

Setting it up

1. 1

   Create the config

   Run MCP: Add Server from the command palette, or create .vscode/mcp.json by hand.

2. 2

   Add the server

   Note the key is servers, not mcpServers - VS Code spells it differently from most clients.

   ConfigCopy

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

3. 3

   Start it

   A Start action appears above the entry in the file. Click it.

Check it worked. Open Chat in agent mode, click the tools icon, and the Refolk tools are in the list.

What VS Code 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.