What is a tool call?
A tool call is the moment an AI agent uses one of its tools, such as asking Spaces to read a conversation or send a reply, instead of only writing text.
In plain words
An AI that can only chat can only write words. A tool gives it a way to do something in the real world: look up a booking, read a message, send a reply.
A tool call is the agent deciding to use one of those tools and asking for it to be done.
It works like a short exchange. The agent picks a tool, fills in the details, such as which chat to read, and sends the request. The service carries it out and sends back the result. The agent then reads the result and carries on.
A single request from you can lead to several tool calls. "Answer the unread messages" might mean one call to list the chats, a few to read them and one reply for each.
Tool calls are where safety matters. The service on the other end decides whether to carry out each request. A good one can say no, and explain why, so the agent can tell you what happened.
How it works in Spaces
Your agent makes tool calls to Spaces through MCP: list chats, read messages, reply, tag a chat, hand a chat to a person and more. Reading is always free.
Each send is checked by Spaces against the account limits before it goes. If a call is refused, nothing is sent and the answer says why.
Related terms
- MCP: MCP, the Model Context Protocol, is an open standard that lets an AI agent connect to an outside service and use its tools, a bit like a universal plug between AI apps and the services they work with.
- AI agent: An AI agent is an AI model, such as ChatGPT, Claude or Grok, that can take actions with tools you give it, like reading a message and sending a reply, rather than only chatting.
- Guardrails: Guardrails are the rules and limits around an AI agent that keep it inside safe bounds, such as how much it can send, what it must refuse and when a person must step in.
- API: An API, or application programming interface, is a set of rules that lets one piece of software ask another to do something, such as send a message or list your conversations.
FAQ
Is a tool call the same as an API call?
They are close. A tool call is how an AI agent triggers a request, often through MCP, and the service handles it like any other API request.
Can I see what my agent did?
Yes. Messages it sent appear in the chat on your own account, and routines show what they did and when.
What if a tool call is refused?
Nothing is sent. The answer explains the reason and when the agent can try again.
Does every message need a tool call?
Sending, reading and tagging all go through tools. Without one, the agent can only write text to you.
Useful next: Docs, Connect your AI agent, Sending limits. Every term: the glossary.