@sidearmdrm/mcp

MCP server for the Sidearm API — protect media from AI training, detect AI-generated content, and search for stolen work.

This package exposes the Sidearm REST API as Model Context Protocol (MCP) tools that AI agents (Cursor, Claude Desktop, Windsurf, etc.) can call directly.

Quick Start

1. Get an API key

Sign up at sdrm.io and create an API key at sdrm.io/api-keys.

2. Configure your agent

Add to your MCP configuration file:

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "sdrm": {
      "command": "npx",
      "args": ["-y", "@sidearmdrm/mcp"],
      "env": {
        "SDRM_API_KEY": "sk_live_..."
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "sdrm": {
      "command": "npx",
      "args": ["-y", "@sidearmdrm/mcp"],
      "env": {
        "SDRM_API_KEY": "sk_live_..."
      }
    }
  }
}

Windsurf (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "sdrm": {
      "command": "npx",
      "args": ["-y", "@sidearmdrm/mcp"],
      "env": {
        "SDRM_API_KEY": "sk_live_..."
      }
    }
  }
}

That's it. Your agent can now call Sidearm tools.

Tools (27)

Discovery

| Tool | Description | |------|-------------| | list_algorithms | Browse available protection algorithms. Filter by category or media type. |

Protection & Extraction

| Tool | Description | |------|-------------| | run_algorithm | Run specific algorithms on media by ID. Returns a job for async processing. | | protect_media | Protect media with a preset level (standard/maximum). Auto-selects algorithms. | | extract_embeddings | Extract raw embedding vectors from media for downstream similarity search or ML pipelines. |

Jobs

| Tool | Description | |------|-------------| | check_job | Poll async job status. Returns progress and results when complete. |

Detection

| Tool | Description | |------|-------------| | detect_ai | Detect whether media was AI-generated. Supports image, video, audio, text. | | detect_fingerprint | Check if media has been previously registered using fingerprint matching. | | detect_membership | Test whether your content was used to train a suspect AI model. |

Search

| Tool | Description | |------|-------------| | search_media | Search for similar media across your indexed library. | | list_searches | List previous searches on your account. |

Media Management

| Tool | Description | |------|-------------| | register_media | Register and index media with optional protection mode (register, search_ready, standard, maximum). | | list_media | List media assets in your library (paginated, filterable). | | get_media | Get details of a specific media asset including protection status and algorithms applied. | | update_media | Update media metadata (e.g., original URL). | | delete_media | Permanently delete a media asset and all associated data. |

Account, Rights & Billing

| Tool | Description | |------|-------------| | get_account | Get your account details — ID, name, email, credit balance, and plan info. | | get_rights | Get C2PA, IPTC, and rights information for a media asset. | | get_billing | View credit balance, usage breakdown, per-algorithm costs, and billing portal link. |

Provenance & Identification

| Tool | Description | |------|-------------| | get_provenance | Get the full provenance chain for an asset — algorithms, C2PA manifest, membership results. | | identify_media | Identify media by its embedded Sidearm fingerprint and extract its C2PA provenance chain. |

Shares

| Tool | Description | |------|-------------| | create_share | Create a shareable link for a detection, search, or provenance result (starts private). | | get_share | Get a shared result by its share ID. | | publish_share | Make a s

... View full README on GitHub