Probe.dev API Documentation (original) (raw)

Overview

The Probe.dev MCP (Model Context Protocol) server enables AI assistants to directly interact with the Probe.dev API and documentation. Our hosted MCP server uses the modern Streamable HTTP transport layer, providing a seamless integration experience.

Key Benefits

✅ No local installation - Fully hosted service
✅ Modern transport - Uses Streamable HTTP (SSE deprecated)
✅ Simple configuration - Just URL and API token
✅ Always up-to-date - Automatically reflects latest API changes
✅ Zero maintenance - No dependencies to manage

What You Can Do

• Search documentation - Find information across all Probe.dev docs
• Analyze media files - Run comprehensive analysis with FFprobe, MediaInfo, Probe Report, C2PA, and MediaStreamValidator
• Manage usage - Check statistics and request logs
• Authenticate requests - Automatically handle API authentication

Supported Clients

The Probe.dev hosted MCP server works with any MCP-compatible client:

Quick Setup

Authentication

The hosted server supports two authentication methods:

Client Configuration

Cursor Setup

1. Create MCP Configuration FileCreate or edit the file ~/.cursor/mcp.json:

mkdir -p ~/.cursor  
touch ~/.cursor/mcp.json  

1. Add Probe.dev Server Configuration

{  
  "mcpServers": {  
    "probe-dev": {  
      "url": "https://mcp.probe.dev/",  
      "headers": {  
        "Authorization": "Bearer your-api-token-here"  
      }  
    }  
  }  
}  

1. Restart Cursor to activate the MCP server

Claude Desktop Setup

1. Locate Configuration File
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. Edit Configuration

{  
  "mcpServers": {  
    "probe-dev": {  
      "url": "https://mcp.probe.dev/",  
      "headers": {  
        "Authorization": "Bearer your-api-token-here"  
      }  
    }  
  }  
}  

1. Restart Claude Desktop

Continue (VS Code) Setup

1. Install Continue Extension from the VS Code marketplace
2. Configure MCP Server in Continue’s settings:

{  
  "mcpServers": [  
    {  
      "name": "probe-dev",  
      "url": "https://mcp.probe.dev/",  
      "headers": {  
        "Authorization": "Bearer your-api-token-here"  
      }  
    }  
  ]  
}  

Once configured, your AI assistant will have access to these tools:

Documentation Search

Tool: search
Description: Search across all Probe.dev documentation
Example: "How do I authenticate with the API?"

Media Analysis

Tool: analyze_media_file
Description: Analyze media files using FFprobe, MediaInfo, Probe Report, C2PA, or MediaStreamValidator
Example: "Analyze this video file: https://example.com/video.mp4"

Usage Statistics

Tool: get_usage_stats
Description: Retrieve API usage statistics and metrics
Example: "Show my current API usage this month"

Request Logs

Tool: get_request_logs
Description: Access your API request history and logs
Example: "Show my recent failed requests"

Testing Your Setup

Basic Connectivity Test

Ask your AI assistant:

Expected Responses

✅ Working correctly - The assistant should:

• Return specific documentation excerpts for searches
• Provide detailed media analysis results
• Show your actual usage statistics

❌ Not working - You might see:

• “I don’t have access to that information”
• “Tool not available” errors
• Authentication failures

Troubleshooting

Usage Examples

Document Search

"Find information about rate limits in the Probe.dev API"
→ Returns: Rate limit documentation with specific limits and headers

Media Analysis

"Analyze this video and tell me its codec, resolution, and duration:
https://example.com/sample.mp4"
→ Returns: Complete FFprobe analysis with video/audio stream details

Batch Operations

"Compare the codecs used in these three video files:
- https://example.com/video1.mp4
- https://example.com/video2.mkv  
- https://example.com/video3.avi"
→ Returns: Analysis of all three files with codec comparison

API Management

"Show me my API usage for the last week and identify any failed requests"
→ Returns: Usage statistics and error log analysis

Security Best Practices

Advanced Configuration

Environment Variable Support

For enhanced security, some clients support environment variables:

{
  "mcpServers": {
    "probe-dev": {
      "url": "https://mcp.probe.dev/",
      "headers": {
        "Authorization": "Bearer ${PROBE_API_TOKEN}"
      }
    }
  }
}

Query Parameter Alternative

If your client doesn’t support headers, use query parameters:

{
  "mcpServers": {
    "probe-dev": {
      "url": "https://mcp.probe.dev/?token=your-api-token-here"
    }
  }
}

Getting Help

Next Steps

Once your MCP server is working:

1. Explore the API - Try different analysis tools and parameters
2. Automate workflows - Use the assistant to streamline media processing
3. Monitor usage - Set up alerts for quota limits
4. Share feedback - Help us improve the MCP integration