Sidearm

Name: Sidearm
Author: sidearmDRM

@sidearmDRM

リポジトリ

Sidearm について

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

#media-protection #watermark #ai-detection #c2pa #copyright #provenance #search #licensing

基本情報

カテゴリ

その他

ライセンス

MIT

ランタイム

node

トランスポート

stdio

公開者

sidearmDRM

投稿者

ebadros

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

List available algorithms for media protection, watermarking, and AI content disruption. Returns algorithm IDs, names, supported media types, and descriptions. Use this to discover valid algorithm IDs before calling run_algorithm. Filter by category (open = research algorithms, proprietary = Sidearm bundles) or media_type (image, video, audio, text, pdf, gif).

Run one or more named algorithms on media. Provide algorithm IDs (from list_algorithms) and either a public media_url or base64-encoded media content. For text, use the text param. Returns a job_id for async processing — use check_job to poll for results. Requires credits.

Extract raw embedding vectors from media using named embedding algorithms. Returns vectors suitable for downstream similarity search, clustering, or ML pipelines. Provide algorithm IDs (from list_algorithms, e.g. dinov2, clip, phash, chromaprint, clap) and either a public media_url or base64-encoded media. Returns a job_id — use check_job to retrieve the vectors once complete.

Protect media using a curated preset level. Automatically selects the best combination of algorithms for the given media type. Simpler than run_algorithm — just specify standard or maximum protection. Provide either a public media_url, base64 media, or text content. Returns a job_id — use check_job to poll for results.

Check the status of an asynchronous job (from run_algorithm, protect_media, or detect_ai). Returns status (queued, processing, completed, failed), progress percentage, and result data including download URLs when complete.

Search for similar or matching media across the indexed library. Provide a media_url or base64 media to find matches. Tiers: exact (hash match), quick (perceptual hash), perceptual (visual similarity), compositional (scene structure), full (all tiers). Returns results immediately.

List previous similarity searches performed on your account. Returns a paginated list of past search queries with timestamps and result counts.

Detect whether media content was generated by AI. Supports images, video, audio, and text/PDF. Runs multiple specialized detection models in parallel for the given media type. Returns a job_id — use check_job to poll for results.

Detect whether media has been previously registered or watermarked. Uses POST /api/v1/detect to compare against your indexed library at varying depth. Tiers: exact (hash match), quick (perceptual hash), perceptual (visual similarity), compositional (scene structure), full (all tiers). Returns results synchronously.

Run membership inference to determine whether your protected content was used to train a suspect AI model. Provide content IDs (from your registered media) and the model to test. Methods: pattern (watermark detection), statistical (distribution analysis), combined (both). Returns a job_id — use check_job to poll for results.

Register and protect media on the Sidearm platform. Modes: register (provenance signing only), search_ready (register + vector indexing), standard (search_ready + watermarks + AI-training poison), maximum (standard + style cloaking + adversarial hardening). Returns the created media object.

List media assets registered to your account. Returns a paginated list with media IDs, types, status, tags, and protection details. Use cursor-based pagination for large libraries.

Get details of a specific registered media asset by ID. Returns metadata, protection status, applied algorithms, tags, and storage information.

Update a registered media asset. Currently supports updating the original media URL (e.g., after re-hosting the original file).

Permanently delete a registered media asset. Removes storage files, vector embeddings, and all associated metadata. This action cannot be undone.

Get your account details — ID, name, email, credit balance, and plan info. Use this to discover your account_id for other endpoints.

Get rights and provenance information for a registered media asset. Returns { rights: { ai_training_allowed, acquire_license_url, ... }, protocols: { c2pa, schema_org, iptc, tdm, rsl } }. No authentication required — this is the public discovery endpoint.

Get billing, usage summary, storage stats, and algorithm breakdown for your account. Returns credit balance, protection/storage cost breakdown, per-algorithm usage, billing events, and a link to the Stripe customer portal. Filter by date range, event type, tags, or API token.

Get the full provenance chain for a media asset. Returns every protection algorithm applied (with versions, timings, and metadata), the C2PA manifest, any AI training membership inference results, and every search where this media appeared as a match. Use this to audit the complete history of what has been done to any media item.

Identify a media asset by its embedded Sidearm fingerprint and extract its C2PA provenance chain. Returns the Sidearm media_id if the asset is registered in your account (null otherwise) and the full ordered C2PA chain (e.g. Nikon Z7II → Adobe Photoshop → sidearm) embedded in the file. Use this to answer 'have I seen this before?' and 'where did this come from?' in one call.

Create a shareable link for a detection, search, or provenance result. The share starts private (is_public: false). Use publish_share to make it public.

Get a shared result by its share ID.

Make a shared result publicly accessible. Sets is_public to true.

List deletion records for your account. Each record documents a media asset that was permanently deleted.

Get details of a specific deletion record, including which algorithms were purged and storage status.

Search the Sidearm API documentation. Returns relevant sections from the full developer reference covering endpoints, request/response formats, authentication, SDKs, algorithms, and usage examples. Use this to look up how to call an endpoint, understand a concept, or find example code. Omit the query to get the overview and index of available topics.

Look up how to perform an action in the Sidearm dashboard UI. Returns step-by-step instructions for dashboard operations such as uploading media, running searches, managing API keys, reviewing deals, buying credits, and more. Use this when the user asks how to do something in the dashboard or web app. Omit the query to get an overview of all available pages.

概要

What is Sidearm?

Sidearm is an MCP (Model Context Protocol) server that exposes the Sidearm REST API as tools for AI agents. It helps protect media from AI training, detect AI-generated content, and search for stolen work.

How to use Sidearm?

Configure the server by adding the npx command and your SDRM_API_KEY to your MCP configuration file (e.g., for Cursor, Claude Desktop, or Windsurf). Once configured, your AI agent can call Sidearm’s 27 tools directly.

Key features of Sidearm

27 tools covering protection, detection, search, and media management
Protect media from AI training with preset levels or specific algorithms
Detect AI-generated content across image, video, audio, and text
Search for similar media using fingerprint matching and membership inference
Manage media library with registration, updates, and deletion records
Access account details, billing, and provenance chains

Use cases of Sidearm

Protect an image from AI training and retrieve the protected file
Detect whether a photo was AI-generated
Check if your artwork was used to train a model like Stable Diffusion
Search for similar media across your indexed library
Get step-by-step instructions for actions in the Sidearm dashboard

FAQ from Sidearm

How do I get an API key?

What tools are available?

Sidearm provides 27 tools for discovery, protection, extraction, jobs, detection, search, media management, account, rights, billing, provenance, identification, shares, deletion records, and documentation.

How do I configure the server for different agents?

Add the npx command with @sidearmdrm/mcp and set SDRM_API_KEY in your MCP configuration file for Cursor, Claude Desktop, or Windsurf.

Can I run the server locally?

Yes, clone the repository, run npm install && npm build, then use the MCP Inspector with SDRM_API_KEY=sk_test_... npx @modelcontextprotocol/inspector node dist/index.js.