Spaces

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

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.