Get Report Metadata (Research)

researchmcp-research_get_report

Fetch full metadata for a known report_id.

Use after one of the search tools (research_article_search, research_chunk_search, research_image_search) when you have a report_id and want more context (full excerpt, modified date) without re-running a search. Cheap direct id lookup. For the full article text use research_read_report; for a public link use research_report_links.

Try queries like

research_get_report(report_id=152777) on an id from a prior search hit; "when was report 152777 published", "details on report 160001".

Parameters

Name	Type	Required	Constraints	Description
report_id	integer	yes	—	The report_id returned by a previous search tool.

Returns

• On hit: {"report": {report_id, title, date, modified, excerpt}}.
• On miss: {"report": None}. Not an error.
• On retrieval failure: {"error": str}.

Try it

Loading interactive widget…

Code examples

curl

curl -s https://mcp.edited.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -H "x-api-key: $MCP_API_KEY" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "researchmcp-research_get_report",
    "arguments": {
      "report_id": 1
    }
  }
}'

TypeScript

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const client = new Client({ name: "demo", version: "1.0.0" }, { capabilities: {} });
await client.connect(
  new StreamableHTTPClientTransport(new URL("https://mcp.edited.com/mcp"), {
    requestInit: { headers: { "x-api-key": process.env.MCP_API_KEY ?? "" } },
  }),
);

const result = await client.callTool({
  name: "researchmcp-research_get_report",
  arguments: {
    "report_id": 1
  },
});

Python

import os
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

headers = {"x-api-key": os.environ["MCP_API_KEY"]}
async with streamablehttp_client("https://mcp.edited.com/mcp", headers=headers) as (read, write, _):
    async with ClientSession(read, write) as session:
        await session.initialize()
        result = await session.call_tool(
            "researchmcp-research_get_report",
            {"report_id": 1},
        )

Input schema

{
  "type": "object",
  "properties": {
    "report_id": {
      "description": "The report_id returned by a previous search tool.",
      "type": "integer"
    }
  },
  "required": [
    "report_id"
  ]
}