🤖

AgentLinks

Pro

Requires a Builder plan for MCP server access

What are AgentLinks?

AgentLinks is the AWSYS.CO MCP (Model Context Protocol) server — a standardised interface that lets AI coding assistants like Claude, Cursor, and other MCP-compatible agents create, update, and query your short links directly from their context window. Instead of writing API code yourself, you simply instruct the AI: "shorten this URL and add UTM parameters for our newsletter campaign," and the agent calls the AWSYS.CO tools automatically.

Requirements

AgentLinks requires a Builder plan. You need an API key (from Settings → Developer) and an MCP-compatible host such as Claude Desktop, Claude Code, or Cursor. The MCP server is hosted by AWSYS.CO — there is nothing to install on your machine beyond configuring the host.

Step-by-step: Connect AWSYS.CO to Claude

Generate a Builder-tier API key from Settings → Developer → API Keys.
Open your Claude Desktop (or Claude Code) configuration file. On macOS this is ~/Library/Application Support/Claude/claude_desktop_config.json.

Add the AWSYS.CO MCP server entry:

{
  "mcpServers": {
    "awsys": {
      "url": "https://awsys.co/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Restart Claude Desktop. The AWSYS.CO tools appear in Claude's tool list.
In a new conversation, you can now say things like: "Create a short link to https://mysite.com/launch with UTM source=twitter and campaign=launch-may-2026" and Claude will call the AWSYS.CO tool automatically.
You can also ask Claude to retrieve analytics for a link, list all links in a folder, or create links in bulk as part of a larger workflow.

Configuration reference

MCP tool	What it does
`create_link`	Shorten a URL with optional slug, UTM, expiry, and click limit
`list_links`	List links with optional folder or search filter
`update_link`	Change destination, expiry, click limit, or OG preview of an existing link
`get_analytics`	Retrieve click analytics for a link within a date range
`delete_link`	Permanently delete a link

Common questions

Does using the MCP server count toward my API call quota?

Yes. Each tool call by the AI agent counts as one API call against your monthly quota. Builder accounts have 10,000 calls per month and 500 per hour, which is sufficient for most AI workflow use cases.

Can I use AgentLinks with Cursor or other editors?

Yes, any MCP-compatible host can connect to the AWSYS.CO MCP server using the same configuration pattern. Check your tool's documentation for where to place the MCP server configuration.

Is the API key safe to store in the config file?

The config file on your local machine is protected by your OS user account. However, treat the API key as a secret — do not commit config files to public repositories. Use environment variable substitution if your MCP host supports it.

Can I see which links were created by an AI agent vs the dashboard?

All links appear in your dashboard regardless of how they were created. API-created links show a small "API" badge in the dashboard link list to distinguish them from dashboard-created links.

← Back to Help Center Open a support ticket