@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_..."
      }
    }
  }
}

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

Tools

Discovery

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

Protection

| 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. |

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. Optionally apply watermarks on ingest. | | list_media | List media assets in your library (paginated). | | get_media | Get details of a specific media asset. | | update_media | Update media metadata (e.g., original URL). | | delete_media | Permanently delete a media asset and all associated data. |

Rights & Billing

| Tool | Description | |------|-------------| | get_rights | Get C2PA, IPTC, and licensing information for a media asset. | | get_billing | View credit usage, API call history, and billing portal link. |

Example Agent Conversations

"Protect this image from AI training"

Agent calls protect_media with the image URL, then check_job to get the protected file.

"What algorithms are available for audio?"

Agent calls list_algorithms with media_type: "audio".

"Run Nightshade and Glaze on my artwork"

Agent calls run_algorithm with algorithms: ["nightshade", "glaze"].

"Is this photo AI-generated?"

Agent calls detect_ai with the image, then check_job for results.

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | SDRM_API_KEY | Yes | Your Sidearm API key (sk_live_... or sk_test_...) | | SDRM_BASE_URL | No | Override the API base URL (default: https://api.sdrm.io) |

Development

git clone https://github.com/sidearmDRM/mcp-server.git
cd mcp-server
npm install
npm run build

Test locally with the MCP Inspector:

SDRM_API_KEY=sk_test_... npx @modelcontextprotocol/inspector node dist/index.js

License

MIT