# Scribase Toolgate

> One API key for every AI tool, part of Scribase (https://scribase.com/toolgate). One `sk-t0-` key (or an OAuth token) reaches a schema-typed catalog of tools: our own products first, then free and public routes, then your own keys. Every call names its provider and its cost in micro-USD; failures are never billed.

## Pages

- [Toolgate](https://toolgate.scribase.com/index.md): the real marketing page, the full pitch and the 5-step launch flow.
- [Pricing](https://toolgate.scribase.com/pricing.md): the billing model (hold/capture/release, spend caps) with live catalog numbers.
- [Docs](https://toolgate.scribase.com/docs.md): quickstart, auth, the tool catalog and billing/metering in one page.

## Use it

- Base URL: https://toolgate.scribase.com
- Get a key: `POST /v1/auth/signup {"org_name": "acme"}` -- no operator in the loop, returns a full-scope key in the same response. Browse pricing first at `https://toolgate.scribase.com/catalog` ([markdown](https://toolgate.scribase.com/catalog.md)).
- Auth: `Authorization: Bearer sk-t0-...` (the same key works on Relay's `/openai/v1`), or OAuth 2.1 (`https://toolgate.scribase.com/.well-known/oauth-authorization-server`).
- MCP: streamable HTTP at `https://toolgate.scribase.com/mcp` (meta-tools `search_tools`, `describe_tool`, `call_tool`, `balance`, `usage`).
- CLI: `sy login`, `sy search "verify an email"`, `sy call rally.email.verify --input '{"email":"a@b.com"}'`.
- Never ask a user for provider API keys. Credentials are stored write-only and injected server-side (`sy cred add <provider> --value-stdin`).

## Endpoints

- `POST /v1/auth/signup` self-serve: `{"org_name"}` -> org + default project + key (shown once). `GET /catalog` human pricing page, `GET /v1/catalog` the same as JSON.
- `GET /v1/tools/search?q=` search by task; `GET /v1/tools/{id}` schemas, price and fallback chain (spends nothing).
- `POST /v1/tools/{id}/call` body `{"input":{},"options":{"provider","max_cost_micros","cache","dry_run"}}`; send `Idempotency-Key` on writes and sends. `{id}` may be a capability (routed, with fallback) or a concrete tool.
- `POST /v1/tools/batch` up to 50 calls under one hold.
- `GET /v1/balance`, `POST /v1/balance/topup`, `GET /v1/usage`, `GET /v1/usage/calls/{id}` (receipt and hash-chain proof).
- Errors: 402 balance (`topup_url`), 429 `cap_exceeded` (names the cap), 422 schema (JSON Pointers, nothing spent), 409 idempotency conflict, 424 every provider failed (nothing billed).

## Capabilities

- `auth.magic_link`: Send a passwordless sign-in link to an app user of a Scribase project. Tools: scribase.auth.magic_link.send (400 µ$ PerSuccess)
- `company.enrich`: Company profile (name, industry, size, location, socials) from a website domain. Tools: rally.company.enrich (5000 µ$ PerSuccess)
- `company.filings`: Recent SEC EDGAR filings (10-K, 10-Q, 8-K ...) for a US-listed company by ticker or CIK. Tools: company.sec.filings (0 µ$ PerCall)
- `company.identity`: Look up a company's legal entity record (LEI, legal name, jurisdiction, address, status) by name or LEI. Tools: company.lei.lookup (0 µ$ PerCall)
- `db.branch`: Create a copy-on-write Scribase database branch for an agent task. Tools: scribase.db.branch.create (10000 µ$ PerSuccess)
- `db.query`: Run a read-only SQL query on a Scribase project database environment or branch. Tools: scribase.db.query (50 µ$ PerSuccess)
- `dev.package.info`: Latest version, description, license and links for a package on npm, PyPI or crates.io. Tools: dev.package.info.registries (0 µ$ PerCall)
- `dev.repo.search`: Search GitHub repositories by keywords, sorted by stars. Tools: dev.github.repos.search (0 µ$ PerCall)
- `domain.dns`: Resolve DNS records (A, AAAA, MX, TXT, CNAME, NS) for a domain over DNS-over-HTTPS. Tools: domain.dns.lookup (0 µ$ PerCall)
- `domain.whois`: Registration data for a domain via RDAP (registrar, creation and expiry dates, status, nameservers). Tools: domain.rdap.whois (0 µ$ PerCall)
- `email.send`: Send one transactional email from a verified sender domain through Rally (unsubscribe footer enforced, rate-limited). Tools: rally.email.send (400 µ$ PerUnit)
- `email.verify`: Check an email address for valid syntax, a mail server (MX), disposable and role-account signals. Tools: rally.email.verify (200 µ$ PerSuccess)
- `geo.geocode`: Turn an address or place name into coordinates (latitude, longitude) with a display name. Tools: geo.geocode.nominatim (0 µ$ PerCall), geo.geocode.photon (0 µ$ PerCall)
- `knowledge.lookup`: A short encyclopedic summary of a topic (Wikipedia page summary). Tools: knowledge.wikipedia.summary (0 µ$ PerCall)
- `leads.search`: Search Rally's lawful company and people data (registries, places, VC database) by filters. Tools: rally.leads.search (2000 µ$ PerResult)
- `llm.chat`: A chat completion from any model on Relay, billed on the same key and balance. Tools: relay.chat.complete (0 µ$ PerCall)
- `research.papers.search`: Find scholarly papers by keywords with title, authors, year, DOI or link. Tools: research.papers.arxiv (0 µ$ PerCall), research.papers.openalex (0 µ$ PerCall)
- `social.search`: Search Hacker News stories and comments by keyword. Tools: social.hn.search (0 µ$ PerCall)
- `speech.tts`: Turn text into spoken audio (edge-tts class voices) and return an audio URL or job. Tools: menivor.tts.speak (50 µ$ PerUnit)
- `video.render`: Script or subject to a rendered short video (async job; poll video.status). Tools: menivor.video.render (20000 µ$ PerUnit)
- `video.status`: Poll a Menivor render job for progress and the final video URLs. Free. Tools: menivor.video.status (0 µ$ PerCall)
- `weather.forecast`: Hourly weather forecast (temperature and precipitation) for coordinates. Tools: weather.forecast.open-meteo (0 µ$ PerCall)
- `web.read`: Fetch a public HTTPS page and return its readable main text as clean markdown with the title. Tools: web.read.readable (0 µ$ PerCall)
- `web.search`: Web search results (title, URL, snippet) for a text query. Tools: web.search.brave (0 µ$ PerCall), web.search.searxng (0 µ$ PerCall)


## Full content

- [llms-full.txt](https://toolgate.scribase.com/llms-full.txt): every tool above with its own price and provider, concatenated in full.

## Machine-readable identity

- [ai.txt](https://toolgate.scribase.com/ai.txt): identity/permissions/restrictions/attribution for AI crawlers.
---

# Scribase Toolgate catalog

One `sk-t0-` key reaches every tool below: our own products first, then free and public routes, then your own keys. Every call names its cost in micro-USD up front; failures are never billed.

Get a key: `POST https://toolgate.scribase.com/v1/auth/signup {"org_name": "acme"}` -- no operator in the loop, returns a full-scope key in the same response.

## Send a sign-in magic link

Send a passwordless sign-in link to an app user of a Scribase project.

| Tool | Provider | Effect | Price |
|---|---|---|---|
| `scribase.auth.magic_link.send` | scribase | send | 400 µ$ / success |

## Enrich a company from its domain

Company profile (name, industry, size, location, socials) from a website domain.

| Tool | Provider | Effect | Price |
|---|---|---|---|
| `rally.company.enrich` | rally | read | 5000 µ$ / success |

## Company SEC filings

Recent SEC EDGAR filings (10-K, 10-Q, 8-K ...) for a US-listed company by ticker or CIK.

| Tool | Provider | Effect | Price |
|---|---|---|---|
| `company.sec.filings` | sec-edgar | read | free |

## Legal entity identifier (LEI)

Look up a company's legal entity record (LEI, legal name, jurisdiction, address, status) by name or LEI.

| Tool | Provider | Effect | Price |
|---|---|---|---|
| `company.lei.lookup` | gleif | read | free |

## Create a database branch

Create a copy-on-write Scribase database branch for an agent task.

| Tool | Provider | Effect | Price |
|---|---|---|---|
| `scribase.db.branch.create` | scribase | write | $0.0100 / success |

## Read-only SQL query

Run a read-only SQL query on a Scribase project database environment or branch.

| Tool | Provider | Effect | Price |
|---|---|---|---|
| `scribase.db.query` | scribase | read | 50 µ$ / success |

## Package registry info

Latest version, description, license and links for a package on npm, PyPI or crates.io.

| Tool | Provider | Effect | Price |
|---|---|---|---|
| `dev.package.info.registries` | package-registries | read | free |

## Search code repositories

Search GitHub repositories by keywords, sorted by stars.

| Tool | Provider | Effect | Price |
|---|---|---|---|
| `dev.github.repos.search` | github | read | free |

## DNS lookup

Resolve DNS records (A, AAAA, MX, TXT, CNAME, NS) for a domain over DNS-over-HTTPS.

| Tool | Provider | Effect | Price |
|---|---|---|---|
| `domain.dns.lookup` | doh | read | free |

## Domain registration (RDAP/WHOIS)

Registration data for a domain via RDAP (registrar, creation and expiry dates, status, nameservers).

| Tool | Provider | Effect | Price |
|---|---|---|---|
| `domain.rdap.whois` | rdap | read | free |

## Send a transactional email

Send one transactional email from a verified sender domain through Rally (unsubscribe footer enforced, rate-limited).

| Tool | Provider | Effect | Price |
|---|---|---|---|
| `rally.email.send` | rally | send | 400 µ$ / recipient |

## Verify an email address

Check an email address for valid syntax, a mail server (MX), disposable and role-account signals.

| Tool | Provider | Effect | Price |
|---|---|---|---|
| `rally.email.verify` | rally | read | 200 µ$ / success |

## Geocode an address or place

Turn an address or place name into coordinates (latitude, longitude) with a display name.

| Tool | Provider | Effect | Price |
|---|---|---|---|
| `geo.geocode.nominatim` | nominatim | read | free |
| `geo.geocode.photon` | photon | read | free |

## Look up a topic summary

A short encyclopedic summary of a topic (Wikipedia page summary).

| Tool | Provider | Effect | Price |
|---|---|---|---|
| `knowledge.wikipedia.summary` | wikipedia | read | free |

## Search companies and people (leads)

Search Rally's lawful company and people data (registries, places, VC database) by filters.

| Tool | Provider | Effect | Price |
|---|---|---|---|
| `rally.leads.search` | rally | read | 2000 µ$ / result |

## LLM chat completion

A chat completion from any model on Relay, billed on the same key and balance.

| Tool | Provider | Effect | Price |
|---|---|---|---|
| `relay.chat.complete` | relay | read | free |

## Search research papers

Find scholarly papers by keywords with title, authors, year, DOI or link.

| Tool | Provider | Effect | Price |
|---|---|---|---|
| `research.papers.arxiv` | arxiv | read | free |
| `research.papers.openalex` | openalex | read | free |

## Search Hacker News

Search Hacker News stories and comments by keyword.

| Tool | Provider | Effect | Price |
|---|---|---|---|
| `social.hn.search` | hn-algolia | read | free |

## Text to speech

Turn text into spoken audio (edge-tts class voices) and return an audio URL or job.

| Tool | Provider | Effect | Price |
|---|---|---|---|
| `menivor.tts.speak` | menivor | read | 50 µ$ / 1k_chars |

## Render a short video

Script or subject to a rendered short video (async job; poll video.status).

| Tool | Provider | Effect | Price |
|---|---|---|---|
| `menivor.video.render` | menivor | spend | $0.0200 / second |

## Video job status

Poll a Menivor render job for progress and the final video URLs. Free.

| Tool | Provider | Effect | Price |
|---|---|---|---|
| `menivor.video.status` | menivor | read | free |

## Weather forecast

Hourly weather forecast (temperature and precipitation) for coordinates.

| Tool | Provider | Effect | Price |
|---|---|---|---|
| `weather.forecast.open-meteo` | open-meteo | read | free |

## Read a web page as markdown

Fetch a public HTTPS page and return its readable main text as clean markdown with the title.

| Tool | Provider | Effect | Price |
|---|---|---|---|
| `web.read.readable` | readable | read | free |

## Search the web

Web search results (title, URL, snippet) for a text query.

| Tool | Provider | Effect | Price |
|---|---|---|---|
| `web.search.brave` | brave | read | free |
| `web.search.searxng` | searxng | read | free |


## Related

- [llms.txt](https://toolgate.scribase.com/llms.txt): the machine-readable index for this whole API.
- [openapi.json](https://toolgate.scribase.com/openapi.json): the full OpenAPI 3.1 spec.