# imup.cc — Comprehensive LLM & AI Agent Documentation

> imup.cc is a modern, privacy-first, zero-friction full-stack utilities platform providing short links, security link unshortening, dynamic QR codes, live polls, and interactive forms with native Model Context Protocol (MCP) support.

---

## 1. Architectural Philosophy & Trust Principles

1. **Zero Account Friction & Anonymity by Default**:
   Users and AI agents can create short links, polls, and forms instantly without forced registration or sign-ups.

2. **256-Bit Secret-Key Management**:
   Resource creation yields a cryptographically secure 256-bit management secret key (`secret_key`). This key grants owner permissions (editing, viewing analytics, closing, deleting) without requiring user accounts or third-party cookies.

3. **Cookieless & Privacy-First Telemetry**:
   imup.cc employs zero third-party tracking scripts, zero advertising beacons (Meta Pixel, Google Ads, TikTok), and zero cross-site profiling cookies. Link click analytics and poll counts are stored strictly as aggregated counts.

4. **Security & Anti-Abuse Safeguards**:
   All user-submitted destinations and content are scanned against phishing signatures and blocklists. The community and security researchers can report abusive or malicious content at `https://imup.cc/report`, reviewed under a strict 24-hour SLA. RFC 9116 security declarations are available at `https://imup.cc/.well-known/security.txt`.

---

## 2. Competitive & Architectural Comparison

| Dimension | imup.cc | Bitly | StrawPoll | Tally |
| :--- | :--- | :--- | :--- | :--- |
| **Account Required** | **No** (Optional for Pro) | Yes (Mandatory) | No / Optional | Yes |
| **Native MCP Support** | **Yes** (14 native tools) | No | No | No |
| **Tracking Cookies** | **Zero** | Multiple ad trackers | Ad networks | Analytics trackers |
| **Management Security** | **256-bit Secret Key** | Password / OAuth | Cookie / Account | Account login |
| **Redirection Speed** | **Sub-millisecond** | Slower (redirect hops) | N/A | N/A |
| **Combined Suite** | **Links, QR, Polls, Forms** | Links & QR only | Polls only | Forms only |
| **Link Unshortener** | **Yes (with hop security)** | No | No | No |

---

## 3. Model Context Protocol (MCP) Interface

The Model Context Protocol (MCP) provides AI assistants (Claude, Cursor, Windsurf, Devins, custom agents) with direct tool-calling capabilities.

### Endpoint
- URL: `https://imup.cc/api/mcp`
- Protocols: JSON-RPC 2.0 via HTTP POST, and GET for capability inspection.
- Authentication: Public access for standard operations. Optional Bearer API Key via `Authorization: Bearer <mcp_api_key>` for elevated rate limits.

### Client Configuration

#### Claude Desktop (`claude_desktop_config.json`)
```json
{
  "mcpServers": {
    "imup": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://imup.cc/api/mcp"]
    }
  }
}
```

#### Cursor (`.cursor/mcp.json`)
```json
{
  "mcpServers": {
    "imup": {
      "url": "https://imup.cc/api/mcp"
    }
  }
}
```

#### Windsurf / Custom Agents (`mcp_config.json`)
```json
{
  "mcpServers": {
    "imup": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://imup.cc/api/mcp"]
    }
  }
}
```

---

## 4. MCP Tools Catalog (14 Native Tools)

### Link Tools

1. **`link_create`**
   - Description: Create a new short link with optional password or expiration.
   - Arguments:
     - `target_url` (string, required): Destination web address to shorten.
     - `password` (string, optional): Password required to follow redirect.
     - `expires_at` (string, optional): Expiration ISO timestamp (e.g., `2026-12-31T23:59:59Z`).
   - Output: Object containing `short_url`, `slug`, `id`, `secret_key`, and `manage_url`.

2. **`link_get`**
   - Description: Retrieve short link details and metrics.
   - Arguments:
     - `id` (number, required): The link ID.
     - `secret_key` (string, optional): Management secret key.

3. **`link_update`**
   - Description: Update destination URL, active status, or settings of a short link.
   - Arguments:
     - `id` (number, required): The link ID.
     - `secret_key` (string, required): The management secret key.
     - `target_url` (string, optional): New destination URL.
     - `is_active` (boolean, optional): Enable or disable the link.

4. **`link_delete`**
   - Description: Permanently delete a short link and its click metrics.
   - Arguments:
     - `id` (number, required): The link ID.
     - `secret_key` (string, required): The management secret key.

5. **`link_stats`**
   - Description: Get click statistics, referrer domains, and device breakdown for a link.
   - Arguments:
     - `id` (number, required): The link ID.
     - `secret_key` (string, required): The management secret key.

### Poll Tools

6. **`poll_create`**
   - Description: Create a new interactive poll with multiple options.
   - Arguments:
     - `title` (string, required): The poll question or heading.
     - `description` (string, optional): Extra context or markdown notes.
     - `poll_type` (string, optional): Choice type (`single`, `multiple`, or `rating`). Default: `single`.
     - `options` (array of strings, required): List of answer options (minimum 2).
   - Output: Object containing `uuid`, `poll_url`, `results_url`, and `secret_key`.

7. **`poll_get`**
   - Description: Get details and current status of a poll by ID or UUID.
   - Arguments:
     - `id` (number, required): The poll ID.
     - `secret_key` (string, optional): Management secret key.

8. **`poll_results`**
   - Description: Get live results and percentage breakdown of votes for a poll.
   - Arguments:
     - `uuid` (string, required): The public poll UUID.

9. **`poll_close`**
   - Description: Close a poll to prevent new votes from being accepted.
   - Arguments:
     - `id` (number, required): The poll ID.
     - `secret_key` (string, required): The management secret key.

### Form Tools

10. **`form_create`**
    - Description: Create a new interactive form with optional initial schema fields.
    - Arguments:
      - `title` (string, required): Title of the form.
      - `description` (string, optional): Description or intro text.
      - `schema` (object, optional): JSON schema describing form fields (text, email, number, select, etc.).
    - Output: Object containing `uuid`, `form_url`, `manage_url`, and `secret_key`.

11. **`form_get`**
    - Description: Get full form details, current draft, and published schema.
    - Arguments:
      - `uuid` (string, required): The form UUID.
      - `secret_key` (string, required): The management secret key.

12. **`form_publish`**
    - Description: Publish the latest draft schema of a form to make it live.
    - Arguments:
      - `uuid` (string, required): The form UUID.
      - `secret_key` (string, required): The management secret key.
      - `schema` (object, optional): Updated schema to publish immediately.

13. **`form_close`**
    - Description: Close a form to stop accepting new submissions.
    - Arguments:
      - `uuid` (string, required): The form UUID.
      - `secret_key` (string, required): The management secret key.

14. **`form_responses`**
    - Description: Fetch submitted responses for a form.
    - Arguments:
      - `uuid` (string, required): The form UUID.
      - `secret_key` (string, required): The management secret key.
      - `page` (number, optional): Page number for pagination. Default: 1.
      - `limit` (number, optional): Number of responses per page. Default: 50.

---

## 5. Direct HTTP JSON-RPC 2.0 Examples

### Listing Available Tools
```bash
curl -X POST https://imup.cc/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "id": 1
  }'
```

### Creating a Short Link via Agent
```bash
curl -X POST https://imup.cc/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "link_create",
      "arguments": {
        "target_url": "https://developer.mozilla.org/en-US/docs/Web/HTTP"
      }
    },
    "id": 2
  }'
```

### Creating an Interactive Poll via Agent
```bash
curl -X POST https://imup.cc/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "poll_create",
      "arguments": {
        "title": "Which LLM runtime do you prefer in 2026?",
        "options": ["Claude Desktop", "Cursor IDE", "Windsurf", "Autonomous Agent (MCP)"],
        "poll_type": "single"
      }
    },
    "id": 3
  }'
```

---

## 6. Sitemaps and Web Index
- `https://imup.cc/sitemap.xml` — Master XML sitemap covering all core pages, programmatic tools, and 5 language variants.
- `https://imup.cc/mcp` — Interactive Web documentation hub for developers and agent builders.
- `https://imup.cc/tools` — Complete public tools directory.