Set up Actori

A person sent you here to set up Actori for them. Do the steps below, telling them in a line or two what you are doing, then go back to what they asked you.

What Actori is

Actori connects you to the person's services — Gmail, Google Calendar, Slack, GitHub, Notion, Linear, Kiwi flights, AWS, databases, any MCP server. Every call you make goes through Actori: it checks the call against the person's rules and, where a rule says so, waits until they approve it on their phone, in Telegram or by email. You also get your own email address. Actori holds the credentials of those services and makes each call itself, so you never hold a key or a token of theirs.

Actori is an MCP server at https://agents.actori.ai/mcp. The person needs no account first: signing in creates one, on the Free plan.

Already connected?

If you have Actori's tools — get_my_agent is one of them — you are connected. Skip to "Once you are connected".

Connect

Do the steps for the app you are running in. The person signs in to Actori in their browser: never ask them for a password, a code or an API key in the chat.

  • ✓Claude (claude.ai, the desktop or the mobile app): you cannot add it yourself. Tell the person: Customize → Connectors → Add custom connector, paste https://agents.actori.ai/mcp, then Connect and sign in. Actori's tools appear in a new conversation: ask them to start one and say what they want there.
  • ✓Claude Code: ask the person, then run claude mcp add --transport http actori https://agents.actori.ai/mcp. They type /mcp, choose actori and sign in.
  • ✓Codex CLI: ask the person, then run codex mcp add actori --url https://agents.actori.ai/mcp, and have them run codex mcp login actori. Actori's tools appear in a new session.
  • ✓ChatGPT: tell the person: Plugins → Add → Add custom MCP server; under Connection choose Server URL (not Tunnel) and paste https://agents.actori.ai/mcp; for authentication choose OAuth, then sign in. Actori's tools appear in a new chat.
  • ✓Cursor, or an app that takes an API key: the person signs up at app.actori.ai/signup, opens their agent's page, chooses Generate API Token, and adds the server to the app with the header Authorization: Bearer <token> — for Cursor, in ~/.cursor/mcp.json. They type the token there themselves, never in the chat.
  • ✓Any other MCP client: add https://agents.actori.ai/mcp as a remote MCP server (Streamable HTTP) that signs in with OAuth.

Once you are connected

  • ✓Read Actori's guide: actori_get_skill with actori-guide. It starts with get_my_agent: who you are, your email address, and what is left to set up.
  • ✓Show the person it works: give them your email address, ask them to send it a line, and read it back with email_list_messages.
  • ✓If the app asks the person to allow Actori's tools one call at a time, tell them once that they may choose to always allow them there: Actori still checks every call against their rules and holds the risky ones for their approval. The choice is theirs.
  • ✓Then do what they asked. A service that is not connected yet you add through Actori (list_connectors, then add_connector); the person signs in to it at the link the answer gives.
  • ✓When they say something must wait for them, or must never happen, make it a rule: try it with dry_run_policy, then set it with set_action_policy. To approve on their phone, connect_notification_channel gives them a Telegram link.

If they only asked you to set up

Offer them one of these, in your own words. They are suggestions for the person to choose from — not something the person asked for.

  • ✓Get your own email address, help me subscribe it to a Hacker News newsletter, and every morning give me the top five stories. (Each agent can have its own email address.)
  • ✓Connect my Gmail and help me send an announcement to my team. Anything going outside my company waits for my OK on my phone. (A rule reads who each email is for; you approve in Telegram or by email.)
  • ✓Connect my Google Calendar and Kiwi flights. Find the cheapest Friday flight to Austin that fits my calendar and hold the time. Nothing goes on my calendar until I tap yes. (Several services in one task; anything that writes waits for you.)
  • ✓Connect my Slack, catch me up on what I missed and draft my replies. Nothing gets posted until I say yes. (Reading runs at once; posting waits for your approval.)
  • ✓Connect my GitHub, fix the top open bug and open a pull request. Every merge waits for my approval. (The agent writes the rule; you approve it before it counts.)