codai

codai Tools API

Native web tools for agents: verified web search, a server-side page fetch with an SSRF guard and asynchronous deep research (`/v1/research`). The contract (names, JSON schemas, limits, how results render for a model) is shared with every codai agent surface — VS Code, desktop, phone, headless CLI, hosted MCP and the SDKs — and lives in `packages/agent-core/spec/tools-web.json`. None of them is a model call, so no usage row is written; each call is metered separately: $3 per 1,000 fast searches, $8 per 1,000 deep searches, $0.50 per 1,000 fetches and $0.20 per research job (plus the job's own model tokens), charged in EUR from your wallet. The first 1,000 calls per user per UTC month are free, and calls made inside a codai agent turn are never charged; errors and cache hits are never charged either. All of them share the per-key request limiter with `/v1/chat/completions` and pass through your rules (a `deny web_search` / `deny browser_fetch` rule is a 403, never an empty result; `deny web_search` also denies research). The `/v1/cards/*` endpoints return data already shaped as card blocks (weather, places, maps, exchange rates, link previews). Weather, exchange rates and link previews are free; Google-backed places, geocoding and static maps write one usage row per upstream call at Google's list price.

GitHub OpenAPI

Operations 16

POST /v1/tools/search Verified web search #
POST /v1/tools/fetch Fetch and extract a public web page #
POST /v1/research Start an asynchronous deep-research job #
GET /v1/research/{id} Poll a deep-research job #
POST /v1/tools/ground Find a described UI element on a screenshot (GUI grounding) #
GET /v1/cards/weather Weather card data (MET Norway) #
GET /v1/cards/places Places card data (Google Places) #
GET /v1/cards/geocode Geocode an address into a map card block #
GET /v1/cards/static-map Static map image for map cards (PNG) #
GET /v1/cards/fx Exchange-rate card data (BNR / ECB) #
GET /v1/cards/route Travel time card data (Google Routes) #
GET /v1/cards/track Parcel tracking card data (Sameday, FAN Courier, Cargus, DPD) #
GET /v1/cards/efactura e-Factura status card data (Brivio) #
POST /v1/cards/product Product card data (schema.org Product) #
POST /v1/cards/unfurl Link preview card data (unfurl) #
POST /v1/cards/render Render a card block to an image (SVG / PNG) #

Documentation

📖
Documentation
https://docs.codai.ro/docs/gateway

Specifications

⚙
OpenAPI
https://artifacts.apis.io/codai-ro/openapi/codai-ro-tools-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/codai-ro/json-schema/codai-ro-tool-search-request-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/codai-ro:codai-ro-tools-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

codai-ro-tools-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Codai Ro Tools API
  version: '1'
  description: 'Operations tagged Tools across 2 of this provider''s published API definitions: codai-ro-gateway-openapi.json, codai-ro-gateway-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://ai.codai.ro
  description: Production
security:
- bearerAuth: []
tags:


# --- truncated at 32 KB (71 KB total) ---
# Full source: https://artifacts.apis.io/codai-ro/openapi/codai-ro-tools-api-openapi.yml