MCP (beta)

Model Context Protocol server

POST /v1/mcp

View as markdown Open in ChatGPT Open in Claude

MCP (Model Context Protocol) endpoint for AI agents. Returns available tools and executes tool calls using JSON-RPC 2.0 protocol.

Beta Notice: This endpoint is in beta. Currently supports Instant Entity Search only. Entity Resolution and Business Intelligence coming soon.

Available Tools:

search_legal_entities: Fast search across 265M+ legal entities

Protocol: Implements MCP JSON-RPC 2.0. Supports tools/list, tools/call, initialize, and notifications/initialized methods.

Learn more: Model Context Protocol

Request body

jsonrpcstring (enum) required
2.0
JSON-RPC version
idoneOf<string | number>
Request ID (optional for notifications)
methodstring (enum) required
tools/listtools/callinitializenotifications/initialized
MCP method to invoke
paramsobject
Method parameters
Show 2 nested fieldsHide nested fields
- namestring
  Tool name (for tools/call)
- argumentsobject
  Tool arguments (for tools/call)
  Show 3 nested fieldsHide nested fields
  namestring
  Entity name to search
  country_codestring
  ISO country code filter
  region_codestring
  Region/state code filter

Responses

200 OK

jsonrpcstring
idoneOf<string | number>
resultobject
Method result
errorobject
Error object (if method failed)
Show 2 nested fieldsHide nested fields
- codeinteger
- messagestring

400 Bad Request

errorobject
An error object.
Show 2 nested fieldsHide nested fields
- messagestring
  The error message
- typestring
  The error code

401 Unauthorized

messagestring
The error object.
request_idstring
The request ID for the error.

500 Internal Server Error

errorobject
An error object.
Show 2 nested fieldsHide nested fields
- messagestring
  The error message
- typestring
  The error code

Example request

cURL

curl --request POST \
  --url 'https://api.savvyiq.ai/v1/mcp' \
  --header 'apikey: YOUR_API_KEY' \
  --header 'content-type: application/json' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Example response

Tools list response200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "search_legal_entities",
        "description": "Search for legal entities (companies) by name with optional geographic and other filters. Returns detailed company information including registration details, addresses, and business status.",
        "inputSchema": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "description": "Company name to search for (required, minimum 2 characters after sanitization)"
            },
            "country_code": {
              "type": "string",
              "description": "ISO country code filter (2-3 characters, e.g., 'US', 'GB', 'CA'). Case insensitive.",
              "pattern": "^[A-Za-z]{2,3}$"
            },
            "region_code": {
              "type": "string",
              "description": "Region/province/state code filter (2-10 alphanumeric characters). Examples: US states ('CA', 'NY'), Canadian provinces ('ON', 'BC'), etc. Case insensitive.",
              "pattern": "^[A-Za-z0-9]{2,10}$"
            }
          },
          "required": [
            "name"
          ],
          "additionalProperties": false
        }
      }
    ]
  }
}