# Introduction (/docs/mcp)



The Paperful MCP server lets AI assistants like Claude and ChatGPT, and coding agents like Claude Code, Codex and Cursor, work with your documents. Once connected, an assistant can search your [papers](/docs/core-concepts/papers), read them and answer questions with references to where the information came from.

You don't need to write any code. Add Paperful to your assistant, sign in, and start asking questions.

## Server URL [#server-url]

```text
https://mcp.paperful.io
```

The server uses the Streamable HTTP transport and signs you in with [OAuth](/docs/mcp/authentication). You'll be asked to sign in to Paperful the first time you connect.

## Connect your assistant [#connect-your-assistant]

<Cards>
  <Card title="Claude" href="/docs/mcp/clients/claude">
    Claude on the web, desktop and mobile.
  </Card>

  <Card title="ChatGPT" href="/docs/mcp/clients/chatgpt">
    ChatGPT with developer mode.
  </Card>

  <Card title="Claude Code" href="/docs/mcp/clients/claude-code">
    Anthropic's coding agent in your terminal.
  </Card>

  <Card title="Codex" href="/docs/mcp/clients/codex">
    OpenAI's coding agent.
  </Card>

  <Card title="Cursor" href="/docs/mcp/clients/cursor">
    The AI code editor.
  </Card>

  <Card title="VS Code" href="/docs/mcp/clients/vscode">
    GitHub Copilot agent mode.
  </Card>
</Cards>

Using something else? Any client that supports remote MCP servers with OAuth can connect. See [Other clients](/docs/mcp/clients/other).

## What assistants can do [#what-assistants-can-do]

| Tool                                         | What it does                                         |
| -------------------------------------------- | ---------------------------------------------------- |
| [`search`](/docs/mcp/tools#search)           | Search the content of every paper in your workspace. |
| [`list_papers`](/docs/mcp/tools#list_papers) | Browse and filter your papers.                       |
| [`read_paper`](/docs/mcp/tools#read_paper)   | Read a paper in full.                                |
| [`whoami`](/docs/mcp/tools#whoami)           | Check which account and workspace are connected.     |

All tools are read-only. Assistants can't change or delete your papers.

## MCP or the API? [#mcp-or-the-api]

|                        | MCP                                   | API and SDKs               |
| ---------------------- | ------------------------------------- | -------------------------- |
| Built for              | AI assistants and agents              | Your own applications      |
| Setup                  | Add a URL and sign in                 | Write code with an API key |
| Who decides what to do | The assistant, based on your question | Your code                  |

Use MCP to give an assistant access to your documents. Use the [API](/docs/api) or [SDKs](/docs/sdks) when you're building your own product on top of Paperful.

## Next steps [#next-steps]

* [Tools](/docs/mcp/tools): what each tool does and accepts.
* [Authentication](/docs/mcp/authentication): permissions and how to disconnect.
* [Ask your papers](/docs/mcp/guides/ask-your-papers): get started with your first questions.
* [Troubleshooting](/docs/mcp/troubleshooting): fix common connection problems.
