Skip to content
xQR Docs

Examples

Here are example conversations showing how AI agents use the xQR MCP tools.

Create a Campaign

You: Create 5 short links for my spring campaign. The URLs are shop.example.com/spring-1 through spring-5. Tag them all with “spring-2026”.

The AI agent calls bulk_create_links with:

{
  "links": [
    { "destination": "https://shop.example.com/spring-1", "labels": ["spring-2026"] },
    { "destination": "https://shop.example.com/spring-2", "labels": ["spring-2026"] },
    { "destination": "https://shop.example.com/spring-3", "labels": ["spring-2026"] },
    { "destination": "https://shop.example.com/spring-4", "labels": ["spring-2026"] },
    { "destination": "https://shop.example.com/spring-5", "labels": ["spring-2026"] }
  ]
}

Check Analytics

You: How are my links performing this month? Which ones get the most scans?

The AI agent:

  1. Calls analytics_summary with period: "30d" to get the overview
  2. Calls analytics_top_links with period: "30d" to get the ranking
  3. Combines the results into a natural language summary

Generate Branded QR Codes

You: Create a QR template with our brand colors (#8B5CF6 foreground on white) and generate a QR code for docs.xqr.co using it.

The AI agent:

  1. Calls create_qr_template with the brand design settings
  2. Calls render_qr_template with the new template ID and content: "https://docs.xqr.co"
  3. Returns the QR code image

Build a Bio Page

You: Set up a link-in-bio page for our product launch with links to our homepage, docs, and Twitter.

The AI agent calls create_bio_page with:

{
  "title": "Product Launch",
  "bio": "Everything you need for our latest release.",
  "links": [
    { "title": "Homepage", "url": "https://example.com" },
    { "title": "Documentation", "url": "https://docs.example.com" },
    { "title": "Twitter", "url": "https://twitter.com/example", "icon": "twitter" }
  ]
}

Then calls publish_bio_page to make it live.

Monitor Workspace Usage

You: Am I close to hitting any plan limits?

The AI agent reads the xqr://workspace/usage resource and summarizes:

You’re on the Business plan. Here’s your current usage:

  • Links: 2,847 / 5,000 this month (57%)
  • API calls: 18,234 / 25,000 (73%)
  • Storage: 1.2 GB / 5 GB (24%)
  • Bio pages: 8 / 25 (32%)

You’re approaching the API call limit. Consider upgrading to Enterprise or reducing automated API usage.

Was this page helpful?