The Tipjai platform api v1, schema v4

Build on Tipjai
without holding
anyone's keys

Read public data right away with no key, connect agents over Remote MCP, receive signed events by webhook, and put a tip button on your site. Everything is read-only: nothing touches money or anyone's payment details.

In plain wordsIf you run a website, a bot or a system of your own, this page shows how to use what anyone can already see on a creator's page, and how to get told when a tip comes in. Nobody gets access to money or account numbers.

Start in 30 seconds →Read the API reference

0API keys to request

5read-only MCP tools

20Link page templates via API

Tip me

POST tip.confirmed X-Tipjai-Signature v1=e8a89c93dfba…

tools/list tipjai_link_get_public_page tipjai_link_validate_draft

GET /api/v1/creator/tipjai "tip_url": "…/tipjai"

Slips, accounts, supporters

Embed buttonembed.js

WebhookHMAC-SHA256

Remote MCP/api/mcp

REST API/api/v1

Never exposedmoney data sits at the bottom

Every layer is read-only. Money data has no way in from outside.

Embed buttonembed.js
WebhookHMAC-SHA256
Remote MCP/api/mcp
REST API/api/v1
Money datanever exposed

Start in 30 seconds

Send your first request
from anywhere

1No sign-up, no key public endpoints are open to read
2CORS is open call from a browser, a server or an agent
3The same data as the web page no PromptPay, no drafts, no per-supporter history

GET /api/v1/creator/tipjai

curl https://tipjai.com/api/v1/creator/tipjai

200application/jsonA real response from tipjai.com, 27 Sep 2026 19:40 (avatar_url removed to keep it short)

{
  "username": "tipjai",
  "display_name": "tipjai.official",
  "bio": "",
  "accent_color": "#D63C4A",
  "category": "talk",
  "categories": [
    "talk",
    "edu",
    "art"
  ],
  "verified": false,
  "verified_handle": null,
  "views": 61,
  "support_activity_visible": true,
  "total_received": 0,
  "supporters": 0,
  "socials": {
    "youtube": "https://www.youtube.com/@Tipjaiofficial",
    "tiktok": "https://www.tiktok.com/@tipjai.official",
    "facebook": "https://www.facebook.com/profile.php?id=61590195677153",
    "x": "https://x.com/Tipjai_official",
    "instagram": "https://www.instagram.com/tipjai.official/",
    "bluesky": "https://bsky.app/profile/tipjai.bsky.social"
  },
  "tip_url": "https://tipjai.com/tipjai"
}

What you can connect

Six ways in, pick the one for your job

Link API and MCP spec in OpenAPI 3.1 →

REST API v1Public profiles, Link pages, supporter leaderboards when the creator allows it, the market and platform stats.GET /api/v1/creator/:usernameRead more →Link API20 templates, known platforms, cited playbooks, JSON Schema and a draft validator that saves nothing.POST /api/v1/link/validateRead more →Remote MCPLet agents read Link pages and templates and validate drafts themselves. Stateless: every request stands alone.https://tipjai.com/api/mcpRead more →WebhookSends tip.confirmed to Zapier, Make or IFTTT, signed with HMAC and retried automatically for up to 24 hours.X-Tipjai-Signature: v1=…Read more →Embed buttonOne script line puts a tip button on your site. Choose the theme, size and label; it opens the tip page in a new tab.<script src="https://tipjai.com/embed.js">Read more →Overlay URLThe alert card and 7 more widgets as URLs for OBS, Streamlabs, TikTok LIVE Studio or anything that takes a browser source./overlay/{token}/goalRead more →

Remote MCP over Streamable HTTP

Teach an agent Tipjai
with one URL

Any client that supports remote HTTP servers can use this URL as is. To run it locally over stdio, use the tipjai-mcp package, which has more tools.

mcp.json

{
  "mcpServers": {
    "tipjai-link": {
      "type": "http",
      "url": "https://tipjai.com/api/mcp"
    }
  }
}

# local stdio
npx -y tipjai-mcp@latest

All five tools, read-only

tipjai_link_get_public_page
Read a published Link page
tipjai_link_list_templates
List every Link page template
tipjai_link_list_platforms
List the known platforms
tipjai_link_get_creator_playbook
Search the cited playbooks
tipjai_link_validate_draft
Validate a draft without saving

Embed button

A tip button on your site, in one line

Paste this line into your Carrd, WordPress or HTML page. The button appears where you paste it and opens your tip page on tipjai.com in a new tab. The payment page is never embedded in anyone's site, for safety.

<script src="https://tipjai.com/embed.js" data-tipjai="your-name" data-label="Tip me"></script>

Tip meTip meTip meTip me

data-tipjai your link name (tipjai.com/this-name)
data-label the button text, up to 40 characters; without it the button says ทิปเลย (Thai for tip me)
data-theme coral dark light outline
data-size sm md lg

Overlay URLs

The alert card and 7 more widgets

They all use the same token as the creator's alert card URL. Add each one as a 1920 x 1080 Browser Source (TikTok LIVE Studio calls it a Link Source). The token belongs to one account: never show it on stream.

/overlay/{token}Alert card
…/goalDonation goal
…/leaderboardSupporter leaderboard
…/tickerTip ticker
…/chatTwitch or YouTube live chat
…/mediaMedia Share
…/utilitySubathon, countdown, clock
…/battleTip battle

Our security promises

Build on top without holding
a creator's keys

When a write API arrives, it will use OAuth 2.1 with a scope per capability, drafts and previews before anything applies, an audit log, and publishing only by the owner.

No tool that writes, publishes or deletes
No PromptPay, bank accounts or per-supporter lists
Every URL and input is bounded
Host and Origin checks, and rate limits

Build on Tipjaiwithout holdinganyone's keys

Send your first requestfrom anywhere