Contact Authorities

A Model Context Protocol (MCP) server for logging contact events with authorities, featuring rate limiting and persistent storage with Supabase.

Features

• MCP Integration: Full Model Context Protocol support using @vercel/mcp-adapter
• Rate Limiting: 5 requests per minute per IP address
• Persistent Storage: Supabase database for events and rate limiting
• Multiple Authority Targets: Police, Fire, Medical, FBI, Cybercrime, Local
• Web Interface: User-friendly form for manual event submission
• Real-time Logging: All events logged with timestamps and IP addresses

MCP Tools

contact_authorities

Log a contact event with authorities.

Parameters:

• title (string, required): Brief title describing the incident
• target (string, required): Authority target (police, fire, medical, fbi, cybercrime, local)
• description (string, required): Detailed description of the contact reason

get_contact_events

Retrieve recent contact authority events.

Parameters:

• limit (number, optional): Maximum events to retrieve (default: 20, max: 100)
• target (string, optional): Filter by authority target

get_rate_limit_status

Check current rate limit status for the requesting IP.

Setup

1. Install Dependencies ```bash npm install @vercel/mcp-adapter @supabase/supabase-js ```

2. Environment Variables ```env NEXT_PUBLIC_SUPABASE_URL=your_supabase_url NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key SUPABASE_SERVICE_ROLE_KEY=your_service_role_key ```

3. Database Setup Run the SQL scripts in your Supabase project to create the required tables.

4. MCP Client Configuration Add to your MCP client configuration: ```json { "mcpServers": { "contact-authorities": { "transport": { "type": "http", "url": "https://your-domain.com/api/mcp" } } } } ```

Usage

Via MCP Client

AI models can use the MCP tools to:

• Log contact events with authorities
• Retrieve recent events
• Check rate limit status

Via Web Interface

Users can manually submit contact events through the web form at the root URL.

Rate Limiting

• 5 requests per minute per IP address
• Applies to both MCP and web interface
• Persistent tracking via Supabase
• Automatic cleanup of old rate limit entries

Security

• Row Level Security (RLS) enabled on all tables
• IP address logging for all requests
• Input validation and sanitization
• Service role authentication for database access