Sugra MCP

{
  "type": "object",
  "title": "sugra_entity_screenArguments",
  "required": [
    "name"
  ],
  "properties": {
    "dob": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Dob",
      "default": null,
      "description": "Optional date of birth for a person, YYYY-MM-DD."
    },
    "name": {
      "type": "string",
      "title": "Name",
      "description": "Person or organization name to screen (required)."
    },
    "country": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Country",
      "default": null,
      "description": "Optional ISO 3166-1 alpha-2 country to narrow the match."
    },
    "nationality": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Nationality",
      "default": null,
      "description": "Optional nationality to narrow the match."
    }
  }
}

{
  "type": "object",
  "title": "sugra_entity_screenDictOutput",
  "additionalProperties": true
}

{
  "title": "Sugra Entity screen",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "title": "sugra_entity_lookupArguments",
  "required": [
    "anchor",
    "value"
  ],
  "properties": {
    "value": {
      "type": "string",
      "title": "Value",
      "description": "The identifier value: 20-character LEI or the VAT number."
    },
    "anchor": {
      "enum": [
        "lei",
        "vat"
      ],
      "type": "string",
      "title": "Anchor",
      "description": "Identifier type: lei (GLEIF) or vat (EU VIES)."
    },
    "include": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Include",
      "default": null,
      "description": "Optional fuller slices to add, e.g. ownership, adverse_media. Omit for the compact default. profile and screening are already in the compact core and are not extra slices."
    }
  }
}

{
  "type": "object",
  "title": "sugra_entity_lookupDictOutput",
  "additionalProperties": true
}

{
  "title": "Sugra Entity lookup",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "title": "search_endpointsArguments",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 10,
      "description": "Maximum ranked hits to return. Default 10. Does not call the Sugra API; this only bounds the catalog search list."
    },
    "query": {
      "type": "string",
      "title": "Query",
      "description": "Natural-language search over the bundled catalog. Name the instrument, series, place, or task (examples: 'US CPI', 'AAPL quote', 'North Sea AIS'). Returns ranked operation_id hits with required_parameters. Then call describe_endpoint on a hit before call_endpoint."
    },
    "source": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Source",
      "default": null,
      "description": "Optional source-family filter as listed by list_sources (macro, markets, ...). An unknown value returns error unknown_source with known_sources."
    },
    "toolset": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Toolset",
      "default": null,
      "description": "Optional catalog group filter (markets, macro, news, network, ...). Call list_toolsets for the live names. An unknown value returns error unknown_toolset with known_toolsets rather than an empty hit list."
    }
  }
}

{
  "type": "object",
  "title": "search_endpointsDictOutput",
  "additionalProperties": true
}

{
  "title": "Search endpoints",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "title": "describe_endpointArguments",
  "required": [
    "operation_id"
  ],
  "properties": {
    "operation_id": {
      "type": "string",
      "title": "Operation Id",
      "description": "Catalog operation_id from search_endpoints (or from list_toolsets drill-down). Unknown ids return error unknown_operation_id."
    }
  }
}

{
  "type": "object",
  "title": "describe_endpointDictOutput",
  "additionalProperties": true
}

{
  "title": "Describe endpoint",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "title": "call_endpointArguments",
  "required": [
    "operation_id"
  ],
  "properties": {
    "body": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Body",
      "default": null,
      "description": "JSON request body for a POST operation, matching the request_body_schema returned by describe_endpoint(operation_id): a JSON object for most operations, or a JSON array when that schema's top-level type is array. Omit for GET operations."
    },
    "limit": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Limit",
      "default": null,
      "description": "Bounds ONLY the records list: the data list, a bare top-level array, or the list inside an object data when exactly one of these keys holds a list: data, entries, events, history, items, observations, points, records, results, rows, series, timeseries (for example data.items). When data has no such single list but every one of its values is an object holding exactly one list named observations, limit bounds each data.<key>.observations list on its own (records_path data.*.observations); fields there still names keys of data. Otherwise, no such list, or several, means the limit does not apply. Keys beside the list such as total and count are not rewritten, and lists nested inside records are never truncated. limit keeps the newest N records when every record carries one date or period key in one format and the list runs one way by it, else the first N, and meta.shaped reports limit_applied, records_path and, for a bounded records list, order (asc, desc or unknown) and kept_end (newest or first), as maps by name for sibling sub-series."
    },
    "fields": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Fields",
      "default": null,
      "description": "Optional projection of keys to keep on each record of the records list: the data list, a bare top-level array, or the list inside an object data when exactly one of these keys holds a list: data, entries, events, history, items, observations, points, records, results, rows, series, timeseries (for example data.items). Keys beside that list such as total and count stay. If a field names a key of data itself, or of a payload without data, that object is projected instead; an object data without such a list is otherwise kept whole. Dotted paths (geo.city) walk nested objects. If no field matches, nothing is removed. meta.shaped reports fields_applied, fields_unmatched and records_path. Omit to keep every key."
    },
    "params": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "title": "Params",
      "default": null,
      "description": "Query and path parameters for this operation_id. Keys and types are operation-specific - call describe_endpoint(operation_id) first to get the exact parameter names, types, and examples. Omit if the operation takes none. A key the operation does not declare returns error unknown_parameters with the accepted names and did_you_mean, before any request is made."
    },
    "include_raw": {
      "type": "boolean",
      "title": "Include Raw",
      "default": false,
      "description": "If true, attach the original unshaped payload under raw when it fits the size cap; otherwise meta.raw_omitted explains why. Default false."
    },
    "operation_id": {
      "type": "string",
      "title": "Operation Id",
      "description": "Catalog operation_id to call, from search_endpoints (or from list_toolsets drill-down). Call describe_endpoint on it first for the parameter names. Unknown ids return error unknown_operation_id before any request is made."
    }
  }
}

{
  "type": "object",
  "title": "call_endpointDictOutput",
  "additionalProperties": true
}

{
  "title": "Call endpoint",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "title": "list_toolsetsArguments",
  "properties": {}
}

{
  "type": "object",
  "title": "list_toolsetsDictOutput",
  "additionalProperties": true
}

{
  "title": "List toolsets",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "title": "fetch_dataArguments",
  "required": [
    "query"
  ],
  "properties": {
    "body": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Body",
      "default": null,
      "description": "JSON body for an auto-selected POST operation; the tool returns the request_body_schema to fill when the match needs one. Pass a JSON object or a JSON array as that schema's top-level type dictates."
    },
    "limit": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Limit",
      "default": null,
      "description": "Bounds ONLY the records list: the data list, a bare top-level array, or the list inside an object data when exactly one of these keys holds a list: data, entries, events, history, items, observations, points, records, results, rows, series, timeseries (for example data.items). When data has no such single list but every one of its values is an object holding exactly one list named observations, limit bounds each data.<key>.observations list on its own (records_path data.*.observations); fields there still names keys of data. Otherwise, no such list, or several, means the limit does not apply. Keys beside the list such as total and count are not rewritten, and lists nested inside records are never truncated. limit keeps the newest N records when every record carries one date or period key in one format and the list runs one way by it, else the first N, and meta.shaped reports limit_applied, records_path and, for a bounded records list, order (asc, desc or unknown) and kept_end (newest or first), as maps by name for sibling sub-series."
    },
    "query": {
      "type": "string",
      "title": "Query",
      "description": "Natural-language request for data (examples: 'US CPI', 'Bitcoin price', 'latest news'). The tool picks the top catalog match and calls it. If required params are missing it returns needs_params instead of guessing."
    },
    "fields": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Fields",
      "default": null,
      "description": "Optional projection of keys to keep on each record of the records list: the data list, a bare top-level array, or the list inside an object data when exactly one of these keys holds a list: data, entries, events, history, items, observations, points, records, results, rows, series, timeseries (for example data.items). Keys beside that list such as total and count stay. If a field names a key of data itself, or of a payload without data, that object is projected instead; an object data without such a list is otherwise kept whole. Dotted paths (geo.city) walk nested objects. If no field matches, nothing is removed. meta.shaped reports fields_applied, fields_unmatched and records_path. Omit to keep every key."
    },
    "params": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "title": "Params",
      "default": null,
      "description": "Parameters for the auto-selected endpoint. If omitted and the best-match endpoint has required parameters, the tool returns that endpoint's required_parameters and examples so you can retry with them filled in."
    },
    "include_raw": {
      "type": "boolean",
      "title": "Include Raw",
      "default": false,
      "description": "If true, attach the original unshaped payload under raw when it fits the size cap; otherwise meta.raw_omitted explains why. Default false."
    }
  }
}

{
  "type": "object",
  "title": "fetch_dataDictOutput",
  "additionalProperties": true
}

{
  "title": "Fetch data",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "title": "list_sourcesArguments",
  "properties": {}
}

{
  "type": "object",
  "title": "list_sourcesDictOutput",
  "additionalProperties": true
}

{
  "title": "List sources",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "title": "resolve_entityArguments",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "title": "Query"
    },
    "type_hint": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Type Hint",
      "default": null
    }
  }
}

{
  "type": "object",
  "title": "resolve_entityDictOutput",
  "additionalProperties": true
}

{
  "title": "Resolve entity",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "title": "get_snapshotArguments",
  "required": [
    "recipe",
    "entity"
  ],
  "properties": {
    "entity": {
      "type": "object",
      "required": [
        "namespace",
        "ids"
      ],
      "properties": {
        "ids": {
          "type": "object",
          "description": "Identifier map from resolve_entity.",
          "additionalProperties": true
        },
        "namespace": {
          "type": "string",
          "description": "Entity namespace from resolve_entity."
        }
      },
      "description": "Entity dict from resolve_entity ({namespace, ids}). Extra keys are ignored.",
      "additionalProperties": true
    },
    "recipe": {
      "type": "string",
      "title": "Recipe"
    }
  }
}

{
  "type": "object",
  "title": "get_snapshotDictOutput",
  "additionalProperties": true
}

{
  "title": "Get snapshot",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "title": "get_timeseriesArguments",
  "required": [
    "metric",
    "entity"
  ],
  "properties": {
    "entity": {
      "type": "object",
      "required": [
        "namespace",
        "ids"
      ],
      "properties": {
        "ids": {
          "type": "object",
          "description": "Identifier map from resolve_entity.",
          "additionalProperties": true
        },
        "namespace": {
          "type": "string",
          "description": "Entity namespace from resolve_entity."
        }
      },
      "description": "Entity dict from resolve_entity ({namespace, ids}). Extra keys are ignored.",
      "additionalProperties": true
    },
    "metric": {
      "enum": [
        "price",
        "macro_series",
        "etf_flows",
        "etf_monthly_flows"
      ],
      "type": "string",
      "title": "Metric"
    },
    "max_points": {
      "type": "integer",
      "title": "Max Points",
      "default": 500
    },
    "granularity": {
      "type": "string",
      "title": "Granularity",
      "default": "1d"
    }
  }
}

{
  "type": "object",
  "title": "get_timeseriesDictOutput",
  "additionalProperties": true
}

{
  "title": "Get timeseries",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

sugra://catalog/domains

sugra://catalog/sources

sugra://attribution

sugra://skills/explore-catalog

sugra://skills/envelope-attribution

sugra://skills/auth-limits

sugra://skills/hosted-vs-gateway

sugra://skills/cross-domain-briefing