Tools

List every tool name — no API key required

The one endpoint on this surface that needs no credentials, so an agent can confirm a tool name is real BEFORE the user has an account. Also served at /tools.json (and /tools.md) on this same host — this /api/tools-catalog path is the same handler and is documented here so it is reachable from the spec. Follow it on the host that served this spec: the catalog names submit and schema endpoints for whichever deployment answered, so fetching it from another host hands you that host's endpoints.

Returns the exact, case-sensitive type string to send to /submit-job, plus each tool's REQUIRED settings. Guessing a name is the most common way generated code fails, and an unrecognised settings key is never rejected, only flagged — so a synonym surfaces as "missing required field", not as an unknown-key error.

Deliberately NOT the whole schema: optional parameters, defaults and descriptions need a key (/tools/{name}/schema). Unlike /tools, this is not account-scoped — it lists what a brand-new public user could submit, so feature-flagged, domain-restricted and API-gated tools are omitted.

get/api/tools-catalog

Request

  • Base URL: https://app.tamarind.bio
  • URL: https://app.tamarind.bio/api/tools-catalog
  • Auth: none required

Query parameters

typestring

Return only this tool, so a caller that already knows the name does not have to pull the whole catalogue into context.

tagstring

Return only tools carrying this intent tag (case-insensitive), e.g. protein-ligand-docking. The full tag list is in the tags field of every response.

format'md'

md returns the catalogue as a Markdown table (text/markdown) instead of JSON.

Response

The public tool catalogue

$commentstring

How to read requiredSettings — that requiredness is usually conditional, which key the tasks predicates refer to, and what the shape-bearing fields mean. Read it before treating the list as a checklist. Declared here because a typed generator exposes only declared properties, and dropping it drops the instructions.

submitEndpointstring

The absolute submit URL, on the host this response was fetched from, with its auth requirement stated. Every route lives under /api/; POST /submit-job is a 404.

schemaEndpointstring

The per-tool full-schema URL. Needs a key.

validateEndpointstring

Dry-run a payload without spending a job. Needs a key too — free of compute, not free of auth.

agentGuidestring

The complete agent guide, on the host this was fetched from.

openapistring

This document, on the host this response was fetched from.

mcpServerstring

MCP endpoint. Not host-derived — there is no per-tenant MCP.

ignoredParamCountinteger

How many query parameters this endpoint did NOT understand. Present only when at least one was ignored, so a request using only type, tag and format is byte-identical to before this field existed. Anything counted here was DROPPED, not applied: ?search=vina returns the whole catalogue with filter absent. Treat a non-zero value as "my filter did not happen" and re-issue with ?type= (exact tool name) or ?tag= (category). Declared here for the same reason as $comment: a typed generator exposes only declared properties, so an undeclared warning is a warning the caller cannot see. The ignored NAMES are deliberately not echoed back — this response is read by agents, and reflecting caller-supplied text into it would make the endpoint a prompt-injection relay for anyone who can choose the URL.

ignoredParamsNotestring

The same fact in prose, for an agent consuming this document as text rather than as a typed object. Present exactly when ignoredParamCount is.

countinteger

Tools in this response, after any type/tag filter

totalCountinteger

Tools in the unfiltered catalogue

tagsstring[]

Every intent tag in use, for the tag parameter

Example response

{
  "submitEndpoint": "POST https://<the-host-that-served-this>/api/submit-job (requires x-api-key)",
  "mcpServer": "https://mcp.tamarind.bio/mcp",
  "tools": [
    {
      "type": "alphafold",
      "displayName": "AlphaFold",
      "tags": [
        "structure-prediction"
      ],
      "taskSetting": "metricType"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.