mcpField
R
raportagent-mcp

raportagent-mcp

Local
github.com/raportagentBusiness & Marketing0Updated 14w ago
Repository

About raportagent-mcp

raportagent-mcp connects MCP clients to RaportAgent for sourced market and compliance research. It creates reports and exposes their content, citations, provenance, and status through the RaportAgent REST API.

Key features

  1. 01Generate reports from research queries
  2. 02Select from report templates
  3. 03Retrieve report status and Markdown
  4. 04Inspect sources and audit provenance
  5. 05Cancel reports and list recent reports
  6. 06Check account plan and credits

Use cases

  1. 01Map a regulatory landscape
  2. 02Research a market or competitor
  3. 03Review citations and report provenance

MCP support

An MCP server that exposes RaportAgent report generation, retrieval, status, source, audit, cancellation, and account operations as tools for MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "raportagent-raportagent": {
      "command": "npx",
      "args": [
        "-y",
        "@raportagent/mcp"
      ],
      "env": {
        "RAPORTAGENT_API_KEY": "<RAPORTAGENT_API_KEY>",
        "RAPORTAGENT_BASE_URL": "<RAPORTAGENT_BASE_URL>"
      }
    }
  }
}
Run commandnpx -y @raportagent/mcp
Environment variables to set
RAPORTAGENT_API_KEYSecretYour RaportAgent API key (create one at raportagent.com under My account -> API keys)
RAPORTAGENT_BASE_URLOverride the API base URL (defaults to https://raportagent.com)

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@raportagent/mcp0.1.2

Tools

6

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
depthenumNodeep = ~15 min, thorough; fast = ~7 min.deep | fast
querystringYesThe market/topic to research, e.g. 'EV charging infrastructure Europe 2026'.
templateenumNoReport shape. Use 'compliance' for a legal/regulatory brief.compliance | pitch | saas | ecommerce | realestate | local
wait_secondsintegerNoIf >0, poll until the report completes or this many seconds elapse (max 1200).

Details

From the project README

RaportAgent MCP server

A Model Context Protocol server that puts RaportAgent inside any MCP client — Claude Desktop, Claude Code, Cursor. Ask your assistant to research a market or map a regulatory landscape, and it generates a sourced RaportAgent report, then pulls the finished markdown and its audit trail.

Thin wrapper over the RaportAgent REST API (/v1), so it inherits per-key rate limits, the credit model, and the audit trail unchanged.

Tools

ToolWhat it does
generate_reportStart a report (query, optional template: compliance/pitch/saas/ecommerce/realestate/local/battlecard/duediligence/fintech). Returns a report_id; optionally polls with wait_seconds. Costs 1 credit (2 for battlecard).
get_report_statusqueued / running / completed / failed
get_reportThe finished report's full markdown + sections
get_report_auditProvenance: AI models, agents, source counts, SHA-256 of the exact content
get_report_sourcesEvery cited source with link-health counts (working / uncertain / dead)
cancel_reportCancel a queued/in-progress report and refund its credit
list_reportsYour recent reports
get_accountRemaining credits and plan

Setup

  1. Get an API key: RaportAgent → My account → API keys (an ra_live_… key).
  2. Register it with your MCP client — no clone, no build, npx pulls the published package.
Claude Desktop

Add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "raportagent": {
      "command": "npx",
      "args": ["-y", "@raportagent/mcp"],
      "env": {
        "RAPORTAGENT_API_KEY": "ra_live_xxx"
      }
    }
  }
}
Claude Code
claude mcp add raportagent -e RAPORTAGENT_API_KEY=ra_live_xxx -- npx -y @raportagent/mcp
Cursor

Same command/args/env shape as Claude Desktop above, under Cursor's MCP settings.

Running from source (contributing / debugging only)
git clone https://github.com/raportagent/raportagent-mcp.git
cd mcp-server
npm install
npm run build

Then point command/args at node / dist/index.js with an absolute path instead of npx.

Config

EnvDefaultNotes
RAPORTAGENT_API_KEY—Required. ra_live_… key.
RAPORTAGENT_BASE_URLhttps://raportagent.comOverride for self-hosted / staging.

Notes

  • Generation typically takes ~15 minutes. generate_report returns immediately with a report_id; the assistant should poll get_report_status (or pass wait_seconds) before get_report.
  • stdout is the MCP transport — the server logs only to stderr.
  • The API key is only ever sent to your configured RAPORTAGENT_BASE_URL.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.