MCP Server

GoodInbound ships a built-in Model Context Protocol server, so AI agents can check availability, book meetings, manage contacts, and inspect forms on your behalf. It speaks Streamable HTTP at one endpoint:

https://goodinbound.com/api/mcp

MCP connections use OAuth 2.1. During browser authorization you choose one project and approve read/write access. Every tool is hard-scoped to that grant, so agents never pass a project ID and cannot reach another project.

Connecting#

Register the endpoint in your MCP client. GoodInbound opens in your browser so you can sign in, choose a project, review access, and approve the connection.

Claude Code

claude mcp add --transport http goodinbound https://goodinbound.com/api/mcp

Then run /mcp in a session and select goodinbound to sign in.

Other MCP clients

{
  "mcpServers": {
    "goodinbound": {
      "type": "http",
      "url": "https://goodinbound.com/api/mcp"
    }
  }
}

Review connected clients under MCP & APIs. Revoking a connection invalidates its access and refresh tokens. The MCP endpoint does not accept REST API keys.

Once connected, ask in plain language: "Book a 30-minute demo with Sarah Chen next Tuesday at 2pm." The agent picks the right tools, checks availability, and confirms the booking.

Available tools#

Read tools return JSON; write tools enforce the same plan limits and validation as the dashboard. create_form always creates a page form, and each step is one page.

Read tools#

Discover IDs and inspect project state. Read tools never change data.

Domain	Tools
Project	`get_project` · `get_project_entitlements` · `get_custom_css`
Bookings	`list_bookings` · `get_booking` · `get_available_slots` · `get_booking_form_response`
Event types	`list_event_types` · `get_event_type`
Calendars	`list_project_calendars` · `get_event_type_calendars`
Schedules	`list_schedules` · `get_schedule`
Contacts	`list_contacts` · `get_contact` · `get_contact_activity` · `get_contact_journeys`
CRM	`list_contact_views` · `list_contact_properties`
Tags	`list_contact_tags` · `get_contact_tag`
Forms	`list_forms` · `get_form` · `list_form_responses` · `get_form_response` · `get_form_response_file`
Workflows	`list_workflows` · `get_workflow` · `list_workflow_runs` · `get_workflow_run`
Activity	`list_recent_activity`
Analytics	`get_analytics_filters` · `get_analytics_overview` · `get_booking_funnel_analytics` · `get_form_funnel_analytics` · `list_analytics_integrations`

Write tools#

Create or change project data. Read the current resource first; destructive and externally visible operations are marked with MCP annotations.

Domain	Tools
Project	`update_project` · `set_custom_css` · `delete_custom_css` · `upload_project_asset` · `delete_project_asset`
Bookings	`create_booking` · `cancel_booking` · `confirm_booking` · `decline_booking`
Event types	`create_event_type` · `update_event_type` · `delete_event_type`
Calendars	`update_event_type_calendars`
Schedules	`create_schedule` · `update_schedule` · `delete_schedule` · `set_schedule_rules` · `add_schedule_override` · `delete_schedule_override`
Contacts	`create_contact` · `update_contact` · `set_contact_next_action` · `complete_contact_next_action` · `delete_contact` · `bulk_update_contacts`
Tags	`create_contact_tag` · `update_contact_tag` · `delete_contact_tag` · `add_tag_to_contact` · `remove_tag_from_contact`
CRM	`create_contact_view` · `update_contact_view` · `delete_contact_view` · `import_contacts` · `set_contact_stage` · `enrich_contact` · `seed_contact_pipeline` · `create_contact_property` · `update_contact_property` · `delete_contact_property`
Forms	`create_form` · `update_form` · `delete_form` · `create_form_step` · `update_form_step` · `delete_form_step` · `reorder_form_steps` · `create_form_field` · `update_form_field` · `delete_form_field` · `reorder_form_fields` · `delete_form_response`
Workflows	`create_workflow` · `update_workflow` · `delete_workflow` · `create_workflow_step` · `update_workflow_step` · `delete_workflow_step` · `reorder_workflow_steps` · `trigger_workflow` · `test_workflow`
Analytics	`configure_analytics_integration`

Analytics tools#

Analytics tools use the same project-scoped aggregates as the REST API. Pass an event type ID or form ID for exact stages; common inputs support preset or custom dates, UTM filters, direct or widget source, and device type. Detailed reports and provider configuration require Pro.

get_booking_funnel_analytics and get_form_funnel_analytics return unique-journey stage visitors, continuation, drop-offs, skips, and context distributions. They never include names, emails, raw answers, journey IDs, IP addresses, or raw errors. configure_analytics_integration accepts only GA4, Meta Pixel, or PostHog public identifiers and a US or EU PostHog host.

Bookings made through MCP trigger your workflows, emails, and calendar sync exactly like the API.