2extract Developer Documentation

Cursor reads MCP servers from a JSON file. You choose whether the server is available everywhere or only inside one repository.

Global or per project?

File	Scope	Use when
`~/.cursor/mcp.json`	Every project	It is your personal key and you want it everywhere
`.cursor/mcp.json`	One repository	The whole team should get the same tools

A project-level .cursor/mcp.json is usually committed. Do not put a real API key in it - add the file to .gitignore, or use the global file instead.

Add the server

mcp.json

{
  "mcpServers": {
    "2extract": {
      "url": "https://mcp.2extract.com/mcp",
      "headers": {
        "Authorization": "Bearer 2xt_YOUR_API_KEY"
      }
    }
  }
}

Already have servers configured? Add 2extract as another key inside the existing mcpServers object.

Verify

Open Settings → Cursor Settings → MCP. 2extract should show as connected, with its tools listed. Then, in the chat panel with Agent mode active:

What is my 2extract balance?

A number comes back. The tool call is shown inline, and you can expand it to see exactly what was sent.

Troubleshooting

Server shows as disconnected in Settings

Check the URL keeps the /mcp path. https://mcp.2extract.com on its own serves a web page, not the protocol.Then use the refresh control next to the server in the MCP settings panel - Cursor does not always re-read the file on save.

Tools are listed but never used

Tools are only available in Agent mode. In Ask mode the model can see them but will not call them.

Everything returns unauthorized

The Authorization header must read Bearer 2xt_... - the word, a space, the key. If you pasted from a terminal, check for a trailing newline inside the quotes.

Project config works for you but not for a teammate

Expected, if the key is yours. Each person needs their own key with their own scopes - keys are per account, and usage is billed to whoever owns the key.

Introduction

MCP Server

MCP Clients

Use Cases

For AI Agents

Cursor

Global or per project?

Add the server

Verify

Troubleshooting

Next steps

Usage Examples

Tools

​Global or per project?

​Add the server

​Verify

​Troubleshooting

​Next steps

Usage Examples

Tools

Global or per project?

Add the server

Verify

Troubleshooting

Next steps