MCP Metadata API

Learn more about discovering available MCP tools, retrieving tool metadata, and accessing input schemas to drive AI and automation workflows with the Reltio API.

The MCP Metadata provides a discovery mechanism for AI-based integrations. It returns metadata for each MCP tool, including its name, display title, description, and input parameter schema. The structure follows the MCP Tool Schema.

Request

Method and URL

GET /ai/tools/metadata/list

Authentication

This API requires OAuth 2.0 authentication. Include a valid access token in the Authorization header:

 "Authorization: Bearer <access_token>"

For more information, see OAuth 2.0/OpenID Connect (OIDC) Single Sign On (SSO).

Response

The response contains a JSON object with a tools array. Each entry describes an MCP tool.

Table 1. Response fields
Field	Type	Description
`tools`	Array	List of available MCP tool definitions
`tools[].name`	String	Internal name used when invoking the tool programmatically
`tools[].title`	String	Human-readable display name for the tool
`tools[].description`	String	Brief explanation of what the tool does
`tools[].inputSchema`	Object	JSON Schema object describing input parameters for the tool
`inputSchema.type`	String	Always “object”. Indicates the tool accepts named parameters
`inputSchema.properties`	Object	Key-value pairs defining parameter names, types, and descriptions
`inputSchema.required`	Array	List of required parameters

Example request


curl -X GET \
  "https://<your-environment>.reltio.com/ai/tools/metadata/list" \
  -H "Authorization: Bearer <access_token>"

Example response


{
  "tools": [
    {
      "name": "get_entity_tool",
      "title": "Get Entity",
      "description": "Retrieve entity details by ID",
      "inputSchema": {
        "type": "object",
        "properties": {
          "entity_id": {
            "type": "string",
            "description": "Unique identifier of the entity to retrieve"
          }
        },
        "required": ["entity_id"]
      }
    }
  ]
}

Usage notes

Call this endpoint to discover which MCP tools are available and how they can be used.
Use each tool’s name value when invoking operations through the MCP execution framework.
The inputSchema describes the exact input parameters and data types expected by each tool.
The returned tool list depends on your role and access permissions.

Unify and manage your data