Skip to main content

Get Report Links (Research)

researchmcp-research_report_links

Convert between report_ids and public EDITED Research article URLs.

Both directions resolve through the report's WordPress slug at read time — nothing about the URL is stored in the index — so this works for every report regardless of when it was embedded. Exactly one direction per call.

report_ids -> URLs. Call it after any search, list, or get tool whose results you cite, batching all cited report_ids into one call, so your final answer includes clickable EDITED Research URLs. Note the public article page requires login: when the user wants the content itself rather than a link, prefer research_read_report.

report_urls -> report_ids. Call it first when the user starts from a link they already have — an article they were notified about and want analysed. The returned report_id is what every other research tool takes: pass it to research_chunk_search(report_ids=[...], query=...) for the passages behind a claim, or to research_read_report for the whole article. A URL that resolves to null is a report that is not published (or not a research article at all) — say so and offer a title search instead of guessing an id.

Try queries like

research_report_links(report_ids=[152777, 160001]) on ids from the search hits you are about to cite; "share a link to report 152777". research_report_links(report_urls=["<the my.edited.com link the user pasted>"]) for "start from this report", "what does this article say about denim".

Parameters​

NameTypeRequiredConstraintsDescription
report_idsinteger[]nomax items: 20report_id values from a previous search/list/get tool, to resolve to article URLs. 1..20 per call — split larger sets across calls. Pass this or report_urls, not both.
report_urlsstring[]nomax items: 20EDITED Research article URLs to resolve to report_ids — use when the user supplies a link rather than an id. Pass this or report_ids, not both.

Returns​

  • On success, one direction populated and the other null:
  • {"result": {"links": {report_id (str): url | null}, "report_ids_by_url": null}}
  • {"result": {"links": null, "report_ids_by_url": {url (str): report_id | null}}}
  • A null value means WordPress resolved nothing for that key (an unknown
  • or unpublished report) — surface "link unavailable" / "report not
  • found", never invent a URL or an id.
  • On failure: {"error": {code, message}}
  • code is invalid_input (neither direction supplied, both supplied,
  • or no URL that a slug could be read from), upstream_unavailable
  • (WordPress, or resolving the caller's config) or not_entitled
  • (authorization refused).

Try it​

Loading interactive widget…

Code examples​

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_report_links",
    "arguments": {}
  }
}'

Input schema​

{
  "type": "object",
  "properties": {
    "report_ids": {
      "description": "report_id values from a previous search/list/get tool, to resolve to article URLs. 1..20 per call — split larger sets across calls. Pass this or `report_urls`, not both.",
      "items": {
        "type": "integer"
      },
      "maxItems": 20,
      "minItems": 1,
      "type": "array"
    },
    "report_urls": {
      "description": "EDITED Research article URLs to resolve to report_ids — use when the user supplies a link rather than an id. Pass this or `report_ids`, not both.",
      "items": {
        "type": "string"
      },
      "maxItems": 20,
      "minItems": 1,
      "type": "array"
    }
  }
}

Output schema​

Describes both branches of the envelope — result on success, error on a refusal. Validate against this rather than pattern-matching the prose above; see Concepts → Response shape.

{
  "type": "object",
  "properties": {
    "result": {
      "properties": {
        "links": {
          "description": "Object keyed by report id (as a string); the value is the public report URL, or null when WordPress returned no slug for that id. Null when the call resolved `report_urls` instead.",
          "title": "Links"
        },
        "report_ids_by_url": {
          "description": "Object keyed by the article URL exactly as it was passed in; the value is the report_id, or null when no published report matches that URL. Null when the call resolved `report_ids` instead.",
          "title": "Report Ids By Url"
        }
      },
      "required": [
        "links",
        "report_ids_by_url"
      ],
      "type": "object"
    },
    "error": {
      "type": "object",
      "description": "Present instead of `result` when the call was rejected. Branch on `code`; never string-match `message`.",
      "properties": {
        "code": {
          "type": "string",
          "enum": [
            "invalid_input",
            "not_entitled",
            "upstream_unavailable",
            "internal"
          ]
        },
        "message": {
          "type": "string"
        },
        "field": {
          "type": "string",
          "description": "Offending parameter, when the failure is attributable to one."
        },
        "details": {
          "type": "object",
          "additionalProperties": true
        }
      },
      "required": [
        "code",
        "message"
      ]
    }
  },
  "oneOf": [
    {
      "required": [
        "result"
      ]
    },
    {
      "required": [
        "error"
      ]
    }
  ],
  "x-fastmcp-wrap-result": true
}