MCP Server

Let AI agents manage your s.id account through the Model Context Protocol.

JSON-RPC 2.0

Overview

The hosted s.id MCP server exposes JSON-RPC tools through one endpoint. Clients can authenticate with the same API key or OAuth 2.0 access token used by the REST API and discover authorization metadata through RFC 9728.

Tools: 28
Endpoint: /mcp
Authentication: API key or OAuth 2.0

Authentication

Use a scoped sk_live_ API key for your own client or complete OAuth 2.0 when an MCP client acts on behalf of a user. Each tool enforces the same scope as its REST equivalent.

OAuth 2.0 guide

https://mcp.s.id/mcp

Connect

Point an MCP-compatible client to the hosted endpoint and provide an API key or OAuth Bearer token. Clients that support RFC 9728 can discover the authorization server automatically.

mcp.json

{
  "mcpServers": {
    "sid": {
      "url": "https://mcp.s.id/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

Tools

Twenty-eight tools cover links, microsites, QR customization, analytics, and account data. Scope requirements remain visible on every screen size.

Links11

create_linklinks:write

Create a short link

bulk_create_linkslinks:write

Create multiple short links in one call

get_linklinks:read

Get a link by ID

list_linkslinks:read

List links

update_linklinks:write

Update a link

delete_linklinks:archive

Archive a link

unarchive_linklinks:write

Restore an archived link

check_short_availabilitylinks:read

Check if a custom slug is available

get_link_statslinks:analytics

Get a link's click timeline

get_link_lifetime_statslinks:analytics

Get a link's lifetime click count

get_account_statslinks:analytics

Get account-level click analytics

Microsites11

create_micrositemicrosites:write

Create a microsite

get_micrositemicrosites:read

Get a microsite by slug

list_micrositesmicrosites:read

List microsites

update_micrositemicrosites:write

Update a microsite

delete_micrositemicrosites:delete

Delete a microsite

check_microsite_slugmicrosites:read

Check if a microsite slug is available

create_microsite_componentmicrosites:write

Add a component to a microsite

list_microsite_componentsmicrosites:read

List a microsite's components

update_microsite_componentmicrosites:write

Update a microsite component

delete_microsite_componentmicrosites:delete

Delete a microsite component

order_microsite_componentsmicrosites:write

Reorder a microsite's components

QR4

get_link_qrqr:read

Get a link's QR code settings

set_link_qrqr:write

Customize a link's QR code

get_global_qrqr:read

Get global QR code settings

set_global_qrqr:write

Customize global QR code settings

Account2

get_user_infouser:read

Get the authenticated user's profile

get_quotauser:read

Get the authenticated user's account quota

A separate quota pool

MCP tool calls draw from their own daily quota, separate from your REST API call quota — using the MCP server does not consume your /v2 API allowance. Only tools/call requests count against it; tools/list and initialize are free.

View your usage

Plan availability

Hosted MCP access is enabled by subscription tier. Check the Developer Dashboard for your account's current availability and usage.

Open Developer Dashboard

Ready to start building?

Create an API key in minutes. Free tier included, no credit card required.

Get your API key