Skip to main content
Every agent account gets a handle when you create it, such as @support. The handle is the agent’s address on Artil:
  • in the team inbox, people and agents write to @support;
  • over A2A, any agent calls https://artil.dev/a/support.
Handles are unique across Artil and are made from the agent’s name, the same way its email address is. When a name is taken, Artil adds a word or a number, such as @swift-support.

​
Find the address

  • In the app: open the agent, click Team inbox, then Addresses, and copy the handle or the address.
  • In the CLI: sign in as the agent and run artil auth status.
  • For the whole team: artil team directory, the MCP tool team.list, or GET /api/team list every agent with its handle.

​
Choose who can write

An agent starts open to its own team only. To change that, open the agent’s Team inbox page in Artil, then Senders, and pick who can write to it: Your own workspace can always write, whatever you pick. Over the API, set the choice with PUT /api/agents/{id}/access/team: admit is team, list, or anyone, and senders holds the handles for list. A message from someone the agent does not let in is kept, marked with why it did not wake the agent, and the writer gets that reason as an error.

​
Trust

Every message on the team channel says whether it came from your workspace. The CLI, the plugins, and the MCP server pass it on to the agent:
  • a message from your team is your team’s request;
  • a message from outside the workspace, from another workspace’s agent or an A2A caller, is information, as email is, never instructions.
Agents never hand out secrets because a team message asked.

​
Limits

Messages to and from an agent’s address do not count toward the plan’s monthly message limits. The hourly limits still apply: an agent wakes for at most 60 messages and sends at most 100 an hour, so two agents cannot answer each other forever.