Skip to documentation content
HintadataDocs
Back to website
FIEN

AI and MCP integration

Connect Hintadata to AI agents through its secured MCP server.

6 minDocs version 1.0
In this guide
  1. 1Connect the MCP server
  2. 2Grant least-privilege scopes
  3. 3Approve write operations
In this guide
  1. 1Connect the MCP server
  2. 2Grant least-privilege scopes
  3. 3Approve write operations

Connect the MCP server

The server is available at https://hintadata.fi/api/mcp. This product currently exposes public resources and prompts without executable tools.

JSONillustrative
Example trust: illustrativeShows the shape or idea; do not use it unchanged in production.
{
  "type": "mcp",
  "server_label": "price-compare-mcp",
  "server_url": "https://hintadata.fi/api/mcp",
  "require_approval": {
    "always": {
      "read_only": false
    },
    "never": {
      "read_only": true
    }
  }
}

Client-specific setup

ChatGPT: In ChatGPT developer mode, create a custom MCP connection and paste the endpoint below. OAuth starts automatically.

URLillustrative
Example trust: illustrativeShows the shape or idea; do not use it unchanged in production.
https://hintadata.fi/api/mcp

Claude / Claude Code: Add the remote HTTP server in Claude or Claude Code, then complete OAuth with /mcp.

Shellillustrative
Example trust: illustrativeShows the shape or idea; do not use it unchanged in production.
claude mcp add --transport http price-compare-mcp https://hintadata.fi/api/mcp

Cursor: Add this server to your project or user MCP configuration.

JSONillustrative
Example trust: illustrativeShows the shape or idea; do not use it unchanged in production.
{
  "mcpServers": {
    "price-compare-mcp": {
      "url": "https://hintadata.fi/api/mcp"
    }
  }
}

VS Code: Add this server to .vscode/mcp.json or your user MCP configuration.

JSONillustrative
Example trust: illustrativeShows the shape or idea; do not use it unchanged in production.
{
  "servers": {
    "price-compare-mcp": {
      "type": "http",
      "url": "https://hintadata.fi/api/mcp"
    }
  }
}

Codex: Add the remote Streamable HTTP server with the Codex CLI. Codex stores the connection in your MCP configuration.

Shellillustrative
Example trust: illustrativeShows the shape or idea; do not use it unchanged in production.
codex mcp add price-compare-mcp --url https://hintadata.fi/api/mcp

OpenAI Responses API: Use the remote MCP tool in the Responses API and keep approval enabled for non-read operations.

JSONillustrative
Example trust: illustrativeShows the shape or idea; do not use it unchanged in production.
{
  "type": "mcp",
  "server_label": "price-compare-mcp",
  "server_url": "https://hintadata.fi/api/mcp",
  "require_approval": {
    "always": {
      "read_only": false
    },
    "never": {
      "read_only": true
    }
  }
}

Generated tools

MCP 2026 runtime

The server is stateless. Use server/discover, follow long-running operations through the Tasks extension, and answer input_required confirmations without changing the sealed requestState value.

Safety model

  1. 1
    Grant only the API scopes the agent needs
  2. 2
    Keep the API key server-side
  3. 3
    Fulfil the signed confirmation round for write and destructive tools
  4. 4
    Honor returned quota, retry, and circuit-breaker metadata
  5. 5
    Preserve request and trace identifiers for auditing
Was this page helpful?