Skip to content

connerlambden/bgpt-mcp

Repository files navigation

BGPT MCP API

Search scientific papers from Claude, Cursor, or any MCP-compatible AI tool.

BGPT is a remote Model Context Protocol (MCP) server that gives AI assistants access to a database of scientific papers built from full-text studies. Unlike typical search tools that return titles and abstracts, BGPT extracts raw experimental data — methods, results, conclusions, quality scores, sample sizes, limitations, and 25+ metadata fields per paper.

MCP Compatible npm License: MIT


Quick Start

Add BGPT to your MCP client — no API key required for the free tier (50 searches).

Option A: Remote Connection (Recommended)

Most modern MCP clients support direct remote connections. BGPT offers two transports:

Transport Endpoint
SSE https://bgpt.pro/mcp/sse
Streamable HTTP https://bgpt.pro/mcp/stream

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "bgpt": {
      "url": "https://bgpt.pro/mcp/sse"
    }
  }
}

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "bgpt": {
      "url": "https://bgpt.pro/mcp/sse"
    }
  }
}

Claude Code (CLI):

claude mcp add bgpt --transport sse https://bgpt.pro/mcp/sse

Cline / Roo Code / Windsurf — same config:

{
  "mcpServers": {
    "bgpt": {
      "url": "https://bgpt.pro/mcp/sse"
    }
  }
}

Tip: If your client supports Streamable HTTP, you can use https://bgpt.pro/mcp/stream instead.

Option B: Via npx (for clients that need a local command)

{
  "mcpServers": {
    "bgpt": {
      "command": "npx",
      "args": ["-y", "bgpt-mcp"]
    }
  }
}

Option C: Install globally

npm install -g bgpt-mcp

Then add to your MCP config:

{
  "mcpServers": {
    "bgpt": {
      "command": "bgpt-mcp"
    }
  }
}

Any MCP Client

Connect to either endpoint:

SSE:              https://bgpt.pro/mcp/sse
Streamable HTTP:  https://bgpt.pro/mcp/stream

That's it. No Docker, no build step.


What You Get

BGPT provides one tool: search_papers

Parameter Type Required Description
query string Yes Search terms (e.g. "CRISPR gene editing efficiency")
num_results integer No Number of results to return (1–100, default 10)
days_back integer No Only return papers published within the last N days
api_key string No Your Stripe subscription ID for paid access

What comes back

Each paper result includes 25+ fields, extracted from the full text:

  • Title & DOI — standard identifiers
  • Methods — experimental design, techniques used
  • Results — raw findings, measurements, statistical outcomes
  • Conclusions — what the authors determined
  • Quality scores — methodological rigor assessment
  • Sample sizes — participant/specimen counts
  • Limitations — acknowledged weaknesses
  • And more — funding, conflicts of interest, study type, etc.

Example

Ask your AI assistant:

"Search for recent papers on CAR-T cell therapy response rates"

BGPT returns structured experimental data your AI can reason over — not just a list of titles.


Pricing

Tier Cost Details
Free $0 50 searches, no API key needed
Pay-as-you-go $0.01/result Billed per result returned. Get an API key at bgpt.pro/mcp

How It Works

Your AI Assistant (Claude, Cursor, etc.)
        │
        │  MCP Protocol (SSE or Streamable HTTP)
        ▼
   BGPT MCP Server
   https://bgpt.pro/mcp/sse
   https://bgpt.pro/mcp/stream
        │
        │  search_papers(query, ...)
        ▼
   BGPT Paper Database
   (full-text extracted data)
        │
        ▼
   Structured Results
   (methods, results, quality scores, 25+ fields)

BGPT is a hosted remote server — your MCP client connects via SSE or Streamable HTTP. No local installation needed.


Use Cases

  • Literature reviews — Ask your AI to survey a topic with real experimental data
  • Evidence synthesis — Ground AI responses in actual study findings
  • Research assistance — Find papers by methodology, outcome, or recency
  • Fact-checking — Verify claims against published experimental results
  • Grant writing — Quickly gather supporting evidence for proposals

Configuration Reference

Server Details

Field Value
Protocol MCP (Model Context Protocol)
Transport SSE (Server-Sent Events) or Streamable HTTP
SSE Endpoint https://bgpt.pro/mcp/sse
Streamable HTTP Endpoint https://bgpt.pro/mcp/stream
Authentication None required (free tier) / Stripe API key (paid)

Full MCP Client Config

{
  "mcpServers": {
    "bgpt": {
      "url": "https://bgpt.pro/mcp/sse"
    }
  }
}

Documentation

Full documentation, FAQ, and setup guides: bgpt.pro/mcp


Support


Contributing

See CONTRIBUTING.md for guidelines on reporting bugs, requesting features, and contributing.


License

This repository (documentation, examples, and configuration files) is licensed under the MIT License.

The BGPT MCP API service itself is operated by BGPT and subject to its own terms of service.