# Tapmy.link for AI agents

Tapmy.link is a free link-in-bio service where every page lives on its own subdomain. A program can register, build and publish a page for a person in one HTTP call, then hand the person a link that makes the account theirs. This documentation is written for that program. Every page here is also available as Markdown: add `.md` to its address.

Other machine-readable surfaces: [/openapi.json](https://tapmy.link/openapi.json) · [/mcp](https://tapmy.link/mcp) · [/skill.md](https://tapmy.link/skill.md) · [/llms.txt](https://tapmy.link/llms.txt) · [/llms-full.txt](https://tapmy.link/llms-full.txt) · [/.well-known/agent-card.json](https://tapmy.link/.well-known/agent-card.json)

## Start here

**[Overview](https://tapmy.link/documentation/agents/overview.md)**  
What Tapmy.link is, what a page contains, what it costs, and what a program is allowed to do here.

**[Quickstart: a page in three calls](https://tapmy.link/documentation/agents/quickstart.md)**  
Check a name, create the page, verify it. Copy-paste curl for each step, with the exact response shape.

**[When you cannot call the API](https://tapmy.link/documentation/agents/no-network.md)**  
What to do if you can only GET, or have no network at all: compose the page JSON and hand the person a one-click link to /new that creates it in their browser.

**[Accounts: provisional and claimed](https://tapmy.link/documentation/agents/accounts.md)**  
The two kinds of account a program can create, what a claim link does, and what happens to pages nobody claims.

**[Authentication and API keys](https://tapmy.link/documentation/agents/authentication.md)**  
Bearer keys: where they come from, how to send them, what they can and cannot do, how the owner revokes them.

## Building a page

**[The page model](https://tapmy.link/documentation/agents/page-model.md)**  
Every field on a page, its type and limits, and which endpoint sets it.

**[Blocks reference](https://tapmy.link/documentation/agents/blocks.md)**  
The six block types with the minimal JSON for each, every optional field, and what the templates do with them.

**[Social platforms](https://tapmy.link/documentation/agents/platforms.md)**  
The 35 platform ids accepted in social and socialRow blocks, with the URL shape each expects. Generated from the code.

**[Templates](https://tapmy.link/documentation/agents/templates.md)**  
The ten templates, what each looks like, and which kind of page it suits. Switching never loses content.

**[Images](https://tapmy.link/documentation/agents/images.md)**  
How to put a photo on a page when all you have is a URL: the upload route, storage keys, kinds and size caps.

**[Short links and app links](https://tapmy.link/documentation/agents/short-links.md)**  
Give a link a path on the owner's subdomain, count taps on it, and send iPhone and Android to different stores.

**[Adult links (18+)](https://tapmy.link/documentation/agents/adult-links.md)**  
How links to OnlyFans, Fansly and similar are handled, what a program must set, and what never appears in the page.

**[Languages](https://tapmy.link/documentation/agents/languages.md)**  
The twenty interface locales, how the account language and the page language differ, and which code to send where.

**[Import from another service](https://tapmy.link/documentation/agents/import.md)**  
Copy the links from a Linktree, Taplink, Beacons or any public link page, or the photo, name and bio from Instagram.

## Verify and hand over

**[Verify the result](https://tapmy.link/documentation/agents/verify.md)**  
Read a public page back as Markdown, check what a visitor will see, and confirm the page is actually published.

**[Statistics](https://tapmy.link/documentation/agents/statistics.md)**  
Views, unique visitors and taps for 7 and 30 days, with a daily series — what an agent can report back to its owner.

**[Handing over to the owner](https://tapmy.link/documentation/agents/handover.md)**  
What to tell the person after the page exists: the two links, what the claim link does, and a message you can send verbatim.

**[Etiquette](https://tapmy.link/documentation/agents/etiquette.md)**  
What a program should and should not do with a page it did not pay for and does not own.

## Reference

**[Endpoints](https://tapmy.link/documentation/agents/endpoints.md)**  
Every HTTP endpoint a program can call, with auth, purpose and a link to the page that explains it. The machine-readable form is /openapi.json.

**[Errors and hints](https://tapmy.link/documentation/agents/errors.md)**  
The error envelope, every code the API can return, and the hint that accompanies each. Generated from the code.

**[Rate limits and housekeeping](https://tapmy.link/documentation/agents/rate-limits.md)**  
Every limit a program can hit, how it is signalled, and the sweep that removes pages nobody claimed or visited.

**[MCP server](https://tapmy.link/documentation/agents/mcp.md)**  
The Model Context Protocol endpoint, its tools, how to connect from Claude, Cursor and other clients, and the one rule about keys.

**[Skill file](https://tapmy.link/documentation/agents/skill.md)**  
A ready procedure for coding agents (Claude Code, Codex, Cursor): when to use Tapmy, the steps, the guardrails.

**[Changelog](https://tapmy.link/documentation/agents/changelog.md)**  
Dated changes to the agent-facing API, the MCP server and this documentation.

## Recipes

**[Recipe: a musician](https://tapmy.link/documentation/agents/recipe-musician.md)**  
A complete request body for a musician: the newest release first, one row of streaming marks, dates, merch, press.

**[Recipe: a restaurant or café](https://tapmy.link/documentation/agents/recipe-restaurant.md)**  
A complete request body for a place: reserve first, then menu, directions, hours, delivery, and a chat button.

**[Recipe: a photographer](https://tapmy.link/documentation/agents/recipe-photographer.md)**  
A complete request body for a photographer: portfolio first, booking, the current offer, prints.

**[Recipe: a coach or consultant](https://tapmy.link/documentation/agents/recipe-coach.md)**  
A complete request body for a coach: one clear offer, a booking link, proof, a way to talk.

**[Recipe: a small shop](https://tapmy.link/documentation/agents/recipe-shop.md)**  
A complete request body for a shop: the current drop, categories as cards, delivery info, support chat.

**[Recipe: a launch](https://tapmy.link/documentation/agents/recipe-launch.md)**  
A complete request body for a product or book launch: one page, one action, a countdown of steps, everything dated.

---
HTML edition: https://tapmy.link/documentation/agents