Upfirst MCP server

The AI answering service for small businesses, now inside your AI assistant.
Ask for last week's calls, fix an answer your receptionist got wrong, or add a transfer rule. No dashboard needed.

What this is

Upfirst answers your business calls with an AI receptionist. The Upfirst MCP server connects your receptionist to AI assistants like Claude, ChatGPT, Cursor, Antigravity, Gemini CLI, and VS Code. You manage it by asking, not by clicking.

Upfirst hosts the server at https://mcp.upfirst.ai. This repository holds only the setup files that AI clients and directories use to connect to it. The server code is not in this repository.

You need an Upfirst account. See plans.

Connect your AI assistant

Every client signs in the same way. The first time it connects, it opens the Upfirst sign-in page. You approve access once. There are no API keys to copy or store.

Claude

Upfirst is in Claude's connector directory. Open claude.ai/directory/upfirst, add Upfirst, and sign in. It works on claude.ai and in the Claude desktop app.

ChatGPT

Open the Upfirst page in ChatGPT, add it, and sign in.

Claude Code

claude mcp add --transport http upfirst https://mcp.upfirst.ai

Then run /mcp in Claude Code and sign in. Add --scope user to use Upfirst in every project.

You can also install Upfirst as a plugin from this repository:

/plugin marketplace add upfirst/upfirst-mcp
/plugin install upfirst@upfirst

Gemini CLI

gemini extensions install https://github.com/upfirst/upfirst-mcp

Then run /mcp auth upfirst in Gemini CLI and sign in.

Antigravity

agy plugin install https://github.com/upfirst/upfirst-mcp

Then sign in:

• Antigravity CLI: run /mcp, choose the Upfirst server (upfirst_upfirst), and select Authenticate.
• Antigravity app: open Agent settings, go to Customizations, and click Authenticate next to Upfirst.

Sign in to Upfirst in the browser, copy the code it shows, and paste it into Antigravity.

Cursor

Click Add to Cursor at the top of this page. Or add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "upfirst": {
      "url": "https://mcp.upfirst.ai"
    }
  }
}

Cursor prompts you to sign in the first time it uses the server. If sign-in fails, update Cursor and try again.

VS Code

Click Install in VS Code at the top of this page. Or add this to .vscode/mcp.json:

{
  "servers": {
    "upfirst": {
      "type": "http",
      "url": "https://mcp.upfirst.ai"
    }
  }
}

Start the server from the play button in the file, then use it in Copilot agent mode.

Codex

Add this to ~/.codex/config.toml:

[mcp_servers.upfirst]
url = "https://mcp.upfirst.ai"

Then run codex mcp login upfirst.

Other clients

Use https://mcp.upfirst.ai as a remote MCP server with the streamable HTTP transport.

What you can do

Area	What your assistant can do	Tools
Account and receptionists	See your account, list your receptionists, and change their settings	get_account_overview, list_agents, get_agent_by_id, update_agent
Greetings	Choose what a receptionist says first, based on the time of the call	list_agent_greetings, create_agent_greeting, update_agent_greeting, delete_agent_greeting
Knowledge	Read and edit what your receptionists know	get_agent_knowledge, create_agent_knowledge, update_agent_knowledge, delete_agent_knowledge
Skills	Add text message and call transfer skills	list_agent_skills, create_sms_skill, update_sms_skill, delete_sms_skill, create_transfer_call_skill, update_transfer_call_skill
Custom actions	Connect a receptionist to your own HTTP APIs	list_custom_actions, create_custom_action, update_custom_action, delete_custom_action
Calls	Find calls and read transcripts	list_calls, get_call_by_id, get_call_transcript

The Upfirst MCP docs describe every tool and its parameters.

Try these prompts

• "Review my calls from the last seven days. Which questions could my receptionist not answer? Suggest knowledge entries that fill the gaps. Do not change anything yet."
• "Read my most recent call. The receptionist gave the wrong opening hours. Fix its knowledge so it answers correctly next time."
• "During business hours, transfer callers who ask about billing to +1 202 555 0100."
• "Set up my receptionist from this description of my business: …"

Security and your data

• Sign-in uses OAuth 2.1 with PKCE. Your assistant never sees your Upfirst password.
• The connection reaches only the organization you signed in to.
• Your assistant can change your settings, not only read them. Treat the connection like being signed in to the dashboard.
• Deletes are permanent. There is no undo.
• Some settings are managed only in the Upfirst dashboard: voice, timezone, and language; scheduling skills; OAuth connections for custom actions; deleting a transfer skill; and importing knowledge from a website. Call recordings are not available over MCP.

Read our Privacy Policy, Terms of Service, Data Processing Addendum, and Security pages.

Help

• Setup for every client and a reference for all tools: upfirst.ai/docs/mcp
• Questions about your account or receptionist: Help Center or support@upfirst.ai
• A setup file in this repository is wrong: open an issue
• A security problem: see SECURITY.md

License

Except for the Upfirst name and the logo files in assets/, the files in this repository are under the MIT License. The Upfirst name and logos belong to Upfirst, Inc.