Skip to main content
AI agents: This page is available as markdown. See also the docs index and full docs.
Use Paperzilla MCP when you want your AI assistant to pull your project feeds directly. Endpoint: https://paperzilla.ai/api/mcp

​
What you can do

  • List your projects
  • Open one project
  • Pull feed items with filters like Must Read, since date, and limit
  • Get the project’s Atom URL

​
Quickstart

​
1. Create your MCP API key

Create a personal MCP key in your Paperzilla dashboard:
  1. Open your dashboard.
  2. Click MCP API key (top-right, key icon).
  3. Click Generate key.
  4. Copy the key and store it securely.
You can also use the same MCP API key panel to revoke the key. If your account does not show that button yet, use the API key endpoints in the developer appendix. Keep this key private. You only see the plaintext value when you create or rotate it.

​
2. Add Paperzilla to your MCP client

Use:
  • URL: https://paperzilla.ai/api/mcp
  • Header: Authorization: Bearer <your-mcp-api-key>
Example config shape: 
{
  "mcpServers": {
    "paperzilla": {
      "transport": {
        "type": "streamable_http",
        "url": "https://paperzilla.ai/api/mcp"
      },
      "headers": {
        "Authorization": "Bearer pzmcp_..."
      }
    }
  }
}

​
3. Ask your assistant to call Paperzilla

Try requests like:
  • “List my Paperzilla projects.”
  • “Show must-read papers for project <project-id> since 2026-02-01 limit 20.”
  • “Get the Atom URL for project <project-id>.”

​
Available tools today

NamePurposeCLI parity
projects.listList your projectspz project list
projects.getGet one projectpz project <id>
feed.getGet project feed with filterspz feed <id> --must-read --since --limit
feed.atom_urlGet Atom URL for a projectpz feed <id> --atom
feed_title_filter (optional prompt)Ask the model to call feed.get and apply title keyword filtering client-sideNo direct CLI equivalent

​
About prompts

You can ignore prompts and use direct tool calls only. If your client supports prompts, feed_title_filter helps with one task:
  • Pull feed items
  • Filter by title keyword in the client/model layer
  • Return filtered results with that behavior clearly stated

​
CLI vs MCP

Use CLI for shell scripts and deterministic command outputs. Use MCP when your assistant should reason across tools and ask follow-up questions. Use RSS/Atom for passive feed-reader polling.

​
Key safety

  • Treat your MCP key like a password
  • Rotate it immediately if exposed
  • Revoke it from MCP API key in the dashboard if you stop using MCP

​
Troubleshooting

  • 401 Unauthorized on /api/mcp: missing, revoked, or invalid MCP API key
  • Empty or unexpected results: confirm you are using the key for the correct Paperzilla account
  • 404 Not Found for project/feed calls: project is not accessible in your account