Repository avatar
AI Tools
v1.0.0
active

sizla

io.github.NeoReader/sizla

Make short links and QR codes and read click stats from your AI assistant.

Documentation

siz.la developer docs

Documentation and examples for the siz.la REST API, webhooks and AI assistant connector. siz.la makes short links, QR codes and link-in-bio pages, and counts every click.

The pages also live at https://siz.la/docs. This repository is the same text, plus runnable examples and the machine-readable files.

Quick start

  1. Sign in at siz.la and make an API key under Settings, then Developers.

  2. Keep it in an environment variable:

    export SIZLA_API_KEY="your key"
    
  3. Shorten a link:

    curl -X POST "https://siz.la/api/url/add" \
      -H "Authorization: Bearer $SIZLA_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"url":"https://example.com/a/long/address","custom":"lunch-menu"}'
    
    { "error": 0, "id": 1042, "shorturl": "https://siz.la/lunch-menu" }
    

What is here

Folder or fileWhat it holds
docs/One page per topic: authentication, links, account, click export, conversions, webhooks, errors and rate limits, and the assistant connector with a page for each assistant
examples/Runnable scripts for every endpoint in cURL, Node.js, Python and PHP, and webhook receivers that check the signature
openapi.jsonThe OpenAPI 3.1 description, the same file as https://siz.la/openapi.json
mcp/server.jsonThe entry for the official MCP registry: a remote server at https://siz.la/mcp with OAuth sign-in
CHANGELOG.mdWhat changed on siz.la, newest first

Use siz.la from an AI assistant

Add https://siz.la/mcp as a remote MCP server in Claude, ChatGPT, Cursor, VS Code or any client that supports them, then sign in and choose Allow. Steps for each are in docs/connector.md.

Keeping this repository current

Everything except this README, CONTRIBUTING, LICENSE, mcp/ and examples/webhooks/ is generated from the siz.la source, so changes to those files are overwritten on the next update. To fix a mistake, open an issue or a pull request and describe what is wrong. See CONTRIBUTING.md.

License

The documentation and examples are MIT licensed. See LICENSE.

No installation packages available.

Remote

streamable-http
https://siz.la/mcp