ActorHub.ai MCP Server

Model Context Protocol (MCP) server for ActorHub.ai - enables AI assistants like Claude to verify identities and check consent in real-time.

What is MCP?

The Model Context Protocol is an open protocol that allows AI assistants to connect to external tools and data sources. This server exposes ActorHub.ai's functionality to any MCP-compatible AI.

Features

• verify_identity - Check if an image/video contains a protected identity
• check_consent - Verify consent status before generating AI content
• browse_marketplace - Explore licensed Actor Packs
• get_identity - Get details about a protected identity
• get_actor_pack - Get Actor Pack information and licensing

Installation

npm install -g @actorhubai/mcp-server

Or run directly with npx:

npx @actorhubai/mcp-server

Configuration

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "actorhub": {
      "command": "npx",
      "args": ["@actorhubai/mcp-server"],
      "env": {
        "ACTORHUB_API_KEY": "your-api-key"
      }
    }
  }
}

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | ACTORHUB_API_KEY | Your ActorHub.ai API key | Required | | ACTORHUB_API_URL | API base URL | https://api.actorhub.ai |

Usage Examples

Once configured, you can ask Claude questions like:

• "Check if this image contains any protected identities: [image URL]"
• "Does [celebrity name] allow their likeness to be used in AI videos?"
• "Browse the Actor Pack marketplace for actors available for licensing"
• "What are the consent requirements for using [identity] in a Runway video?"

Available Tools

verify_identity

Verify if an image or video contains a protected identity.

Parameters:

• image_url (required): URL of the image to verify
• video_url (optional): URL of the video to verify

check_consent

Check consent status for using an identity.

Parameters:

• identity_id (required): ID of the identity
• usage_type (required): Type of usage (ai_video_generation, ai_image_generation, deepfake, marketing, entertainment, education)
• platform (optional): Platform name (runway, sora, kling, etc.)

browse_marketplace

Browse available Actor Packs.

Parameters:

• category (optional): Filter by category (celebrity, model, actor, influencer, custom)
• min_price (optional): Minimum price in USD
• max_price (optional): Maximum price in USD

get_identity

Get detailed information about a protected identity.

Parameters:

• identity_id (required): ID of the identity

get_actor_pack

Get information about a specific Actor Pack.

Parameters:

• pack_id (required): ID of the Actor Pack

Resources

The server also provides documentation resources:

• actorhub://docs/overview - Platform overview
• actorhub://docs/api - API reference

Development

# Clone the repository
git clone https://github.com/actorhubai/actorhub-mcp.git
cd actorhub-mcp

# Install dependencies
npm install

# Run in development mode
ACTORHUB_API_KEY=your-key npm run dev

# Build
npm run build

License

MIT License - see LICENSE

Links

• ActorHub.ai
• API Documentation
• Get API Key
• MCP Protocol