English Français العربية

io.github.ebadros/sidearm

Registre officiel IA et agents

Protect media from AI training, detect AI-generated content, and find stolen work.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @sidearmdrm/mcp
Claude Code 
claude mcp add sidearm -e 'SDRM_API_KEY=<your sdrm_api_key>' -e 'SDRM_BASE_URL=<SDRM_BASE_URL>' -- npx -y @sidearmdrm/mcp@0.9.2
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "sidearm": {
            "command": "npx",
            "args": [
                "-y",
                "@sidearmdrm/mcp@0.9.2"
            ],
            "env": {
                "SDRM_API_KEY": "<your sdrm_api_key>",
                "SDRM_BASE_URL": "<SDRM_BASE_URL>"
            }
        }
    }
}

Variables d'environnement

  • SDRM_API_KEY secret Your Sidearm API key (sk_live_... or sk_test_...). Optional — documentation tools work without it.
  • SDRM_BASE_URL Override the API base URL (default: https://api.sdrm.io)

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. @sidearmdrm/mcp
  2. Quick Start
  3. Tools (27)
  4. Example Agent Conversations
  5. Environment Variables
  6. Development
  7. License

@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
ToolDescription
list_algorithmsBrowse available protection algorithms. Filter by category or media type.
Protection & Extraction
ToolDescription
run_algorithmRun specific algorithms on media by ID. Returns a job for async processing.
protect_mediaProtect media with a preset level (standard/maximum). Auto-selects algorithms.
extract_embeddingsExtract raw embedding vectors from media for downstream similarity search or ML pipelines.
Jobs
ToolDescription
check_jobPoll async job status. Returns progress and results when complete.
Detection
ToolDescription
detect_aiDetect whether media was AI-generated. Supports image, video, audio, text.
detect_fingerprintCheck if media has been previously registered using fingerprint matching.
detect_membershipTest whether your content was used to train a suspect AI model.
ToolDescription
search_mediaSearch for similar media across your indexed library.
list_searchesList previous searches on your account.
Media Management
ToolDescription
register_mediaRegister and index media with optional protection mode (register, search_ready, standard, maximum).
list_mediaList media assets in your library (paginated, filterable).
get_mediaGet details of a specific media asset including protection status and algorithms applied.
update_mediaUpdate media metadata (e.g., original URL).
delete_mediaPermanently delete a media asset and all associated data.
Account, Rights & Billing
ToolDescription
get_accountGet your account details — ID, name, email, credit balance, and plan info.
get_rightsGet C2PA, IPTC, and rights information for a media asset.
get_billingView credit balance, usage breakdown, per-algorithm costs, and billing portal link.
Provenance & Identification
ToolDescription
get_provenanceGet the full provenance chain for an asset — algorithms, C2PA manifest, membership results.
identify_mediaIdentify media by its embedded Sidearm fingerprint and extract its C2PA provenance chain.
Shares
ToolDescription
create_shareCreate a shareable link for a detection, search, or provenance result (starts private).
get_shareGet a shared result by its share ID.
publish_shareMake a shared result publicly accessible.
Deletion Records
ToolDescription
list_deletionsList deletion records documenting permanently deleted assets.
get_deletionGet details of a specific deletion record including purged algorithms and storage status.
Documentation
ToolDescription
search_docsSearch the Sidearm API documentation. Returns relevant sections from the full developer reference.
navigate_uiLook up how to perform actions in the Sidearm dashboard. Returns step-by-step instructions.

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.

"Was my artwork used to train Stable Diffusion?"

Agent calls detect_membership with your media IDs and the model name.

"How do I upload files in the dashboard?"

Agent calls navigate_ui with query: "upload files" for step-by-step instructions.

Environment Variables

VariableRequiredDescription
SDRM_API_KEYYesYour Sidearm API key (sk_live_... or sk_test_...)
SDRM_BASE_URLNoOverride 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

Questions fréquentes

Qu'est-ce que io.github.ebadros/sidearm ?

Protect media from AI training, detect AI-generated content, and find stolen work.

Comment installer io.github.ebadros/sidearm ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add sidearm -e 'SDRM_API_KEY=<your sdrm_api_key>' -e 'SDRM_BASE_URL=<SDRM_BASE_URL>' -- npx -y @sidearmdrm/mcp@0.9.2. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.ebadros/sidearm ?

Oui. Il attend SDRM_API_KEY, à renseigner dans sa configuration.

io.github.ebadros/sidearm est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.ebadros/sidearm ?

Il est publié par sidearmDRM. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.