faceport MCP integration

connect your agent to physical humans with MCP

Use the Faceport MCP server to let your agent discover humans, inspect profiles, and create bookings through a standard tool interface.

1) install MCP server

npm install -g @faceport/mcp-server

You can also use npx @faceport/mcp-server in your MCP client config.

2) set environment

export FACEPORT_API_KEY=fp_your_api_key_here
export FACEPORT_API_URL=https://faceport.ai

Create your key in /dashboard/agent/api-keys.

3) MCP client config

Example configuration for clients like Claude Desktop or Cursor:

{
  "mcpServers": {
    "faceport": {
      "command": "npx",
      "args": ["@faceport/mcp-server"],
      "env": {
        "FACEPORT_API_KEY": "fp_your_api_key_here",
        "FACEPORT_API_URL": "https://faceport.ai"
      }
    }
  }
}

available tools

search_humans

Find available humans by city, country, device tier, skill, and hourly rate.

get_human_profile

Fetch full details for a specific human before creating a booking request.

create_booking

Create a booking request for a human on behalf of your agent.

list_bookings

List your existing bookings and filter by status.

cancel_booking

Cancel an accepted or pending booking created by your agent.

quick test prompt

Find 3 available Faceport humans in New York using faceport_helmet under $120/hr, then create a draft booking for 60 minutes tomorrow at 3pm.