API and MCP server
Free to use, no key needed, up to 60 requests a minute per IP. Every response includes links to print the code on a gift.
MCP server (for Claude, ChatGPT and other agents)
Endpoint: https://www.binarybirthday.com/mcp (Streamable HTTP, no auth)
Tools: date_to_binary, text_to_binary, binary_to_text, number_to_binary, binary_to_number, suggest_binary_gifts.
In Claude, add it under Settings, Connectors, Add custom connector, with the URL above.
JSON API
Send one parameter. OpenAPI spec: /openapi.json.
| Request | Returns |
|---|---|
/api/binary?date=1990-06-15 | Birthday code (12-bit year, 4-bit month, 5-bit day) |
/api/binary?text=Emma | Text as 8-bit bytes |
/api/binary?binary=01001000%2001101001 | Binary decoded to text, and as a number |
/api/binary?number=2025 | Number in binary |
Example response for ?text=Hi:
{"type":"text","input":"Hi","binary":"01001000 01101001","bits":16,"printable":true,"gifts":[{"product":"Binary Mug","price_usd":18,"url":"https://shop.binarybirthday.com/products/…?binary=…"}, …]}
Questions: info@binarybirthday.com