# Agentfonts

> A font marketplace for AI agents. Find fonts by style, glyph coverage and price, read machine-readable licence terms, and buy a licence for a person or organisation, paying per licence in USDC with x402 on Base.

Licences are always issued to a named licensee (a person or organisation), never to the agent itself. Ask the user who the licensee is and confirm the price before buying.

## MCP server

- Endpoint: https://agentfonts.com/mcp (streamable HTTP, no authentication needed to browse)
- search_fonts: filter by free text, tags, required glyphs (e.g. "åäöŊŋ"), script and max price for a use/tier
- preview_font: metrics, styles, scripts and which characters of a sample text are missing
- get_family: every style of a family with its price, bundle offers (family, variable, collection) and the foundry's licence types with their dimensions and tiers
- quote_license: price in USD/USDC and JSON terms. Choose what: font_id (one style), font_ids (several styles of one family) or bundle_id. Choose how: use (desktop, web, app, ebook, server, or a foundry's own) and options, e.g. {"computers": 10}, {"visitors": 200000, "domains": 2}, {"cores": 8, "years": 2}. tier is shorthand for the first dimension
- buy_license: same arguments plus licensee; without "payment" returns x402 payment requirements; with a base64 x402 payment payload it settles and returns a signed licence and one download link per style

## HTTP + x402

- POST https://agentfonts.com/v1/license?font_id=…&use=…&<dimension>=… with {"licensee": {...}} (or font_ids=a,b or bundle_id=…; dimensions such as computers, visitors, domains, apps, titles, cores, years; tier= sets the first) answers 402 with "accepts"; retry with the X-PAYMENT header to receive the licence (X-PAYMENT-RESPONSE carries the transaction)
- GET https://agentfonts.com/v1/license/verify?token=… checks a licence
- GET https://agentfonts.com/v1/quote?… (same parameters) returns the price and JSON terms without MCP
- GET https://agentfonts.com/v1/families/{family_id or font_id} lists styles, bundles and licence types
- GET https://agentfonts.com/v1/info shows network, USDC contract and fees
- Licence text: https://agentfonts.com/eula/ (standard licence; a foundry's own EULA, terms.foundry_eula_url, applies on top). Marketplace terms: https://agentfonts.com/terms/ . Privacy policy: https://agentfonts.com/privacy/ . Contact: info@agentfonts.com

## Selling fonts (foundries)

A foundry is anyone who designs and sells typefaces: a studio or a single type designer. Human guide: https://agentfonts.com/sell/ . Web app: https://agentfonts.com/foundry/ (the same page registers new foundries and signs in existing ones).

An agent can onboard a foundry on behalf of its owner. Only do this for someone who owns the rights to the fonts, with their consent.

1. Register: POST https://agentfonts.com/v1/foundries with JSON {"name", "domain", "email", "wallet"} (wallet = 0x… USDC address on Base). The response has api_key (starts with fm_, shown once; give it to the owner) and foundry.verify_token.
2. Prove the domain: the owner adds a DNS TXT record _agentfonts.<domain> = verify_token, or serves verify_token at https://<domain>/.well-known/agentfonts.txt. Then POST https://agentfonts.com/v1/foundries/me/verify with header Authorization: Bearer <api_key>.
3. Upload: POST https://agentfonts.com/v1/fonts (multipart/form-data) with field file (OTF/TTF, max 10 MB, one style per file) and optional classification, tags (comma-separated) and base_price_usd (this style, desktop, 1–5 computers). Styles with the same family name are grouped into one family. The response lists ownership checks: vendor URL in the font must be on the verified domain, outlines must not already be listed, open-licence fonts (OFL, Apache) must be priced 0. Fonts that fail a check wait for manual review.
4. Prices: PATCH https://agentfonts.com/v1/fonts/{id} {"base_price_usd": n} per style; PUT https://agentfonts.com/v1/families/{id}/bundles/{family|variable|collection} {"price_usd": n} (0 removes); GET/PUT https://agentfonts.com/v1/foundries/me/license-model (licence types, dimensions, tiers and multipliers; null resets to the default).
5. Follow up: GET https://agentfonts.com/v1/foundries/me (earnings: held, payable, paid), GET https://agentfonts.com/v1/foundries/me/fonts and GET https://agentfonts.com/v1/foundries/me/families.

Partners (platforms that sell licences through Agentfonts, e.g. AI site builders): send your partner key as Authorization: Bearer af_partner_… on /mcp or /v1/, or pay from a registered partner wallet. Sales are attributed and your share is taken from the platform fee, never from the foundry's. Ask info@agentfonts.com for a partner key.

Payouts: the foundry's share (100 % minus the platform fee, see /v1/info) is held for the hold period, then paid in USDC on Base to the registered wallet.