MCP Servers

The Model Context Protocol lets AI assistants call the s.id API directly. The server is hosted, so there is nothing to install. Endpoint: POST https://mcp.s.id/mcp (Streamable HTTP, JSON-RPC 2.0)

Connect a client

Authentication uses the same credentials as the API: an API key or an OAuth 2.0 token. Pick your AI app below and replace sk_live_... with an API key from Dashboard > Developer.

In claude.ai or Claude Desktop, open Settings > Connectors > Add custom connector, paste the URL below, then sign in with your s.id account (OAuth). No API key needed.

https://mcp.s.id/mcp

OAuth-capable clients can find the authorization server through https://mcp.s.id/.well-known/oauth-protected-resource.

Example prompts

Once connected, ask in plain language. The assistant picks the right tools.

• >Make me a short link for https://example.com/catalog-2026 titled 'Holiday Catalog'.

  Copy
  Tools used:create_link

• >Check whether the alias [promo-name] is still free, and if it is, use it for https://example.com/promo.

  Copy
  Tools used:check_short_availabilitycreate_link

• >How many clicks did my links get this week, and from which countries?

  Copy
  Tools used:get_account_statsget_link_stats

• >Create a QR code for that catalog link in red with the logo in the middle.

  Copy
  Tools used:get_link_qrset_link_qr

• >Build a microsite for my shop with a WhatsApp button, a catalog link, and opening hours.

  Copy
  Tools used:create_micrositecreate_microsite_component

• >Archive every link that got no clicks in the last 90 days.

  Copy
  Tools used:list_linksget_link_lifetime_statsdelete_link

• >How much link and microsite quota do I have left this month?

  Copy
  Tools used:get_quota

Tools and scopes

There are 28 tools. Each tool requires the same scope as its REST endpoint.

MCP quota is separate from the REST API quota. Quota is only used by tools/call, while the initialize handshake and tools/list are free.