MCP
Tools reference
The nine tools your MCP server exposes, with their parameters and what each returns.
These are the tools of your MCP server. Every one runs on your own AI, with your private context. Each one is marked with the behavior hints MCP clients use to decide when to ask before calling it.
The uare.ai Experts MCP server has three tools of its own, for visitors: see its tools.
| Tool | Does | Behavior |
|---|---|---|
generate_post |
Drafts a social post in your voice | Drafts text |
respond_as_me |
Drafts a reply in your voice | Drafts text |
decide |
Applies your decision framework | Drafts text |
refuse |
Checks whether your AI would decline a request | Read-only |
act |
Works through your connected apps | Reads now, stages writes |
confirm_action |
Carries out a staged write | Writes |
learn |
Queues a fact for your AI's knowledge | Queues for review |
list_skills |
Lists your skills and preferences | Read-only |
get_skill |
Reads one skill in full | Read-only |
generate_post
Composes a social media post in your voice. Your AI draws on its knowledge and your voice profile and returns the finished post. It doesn't publish anything.
| Parameter | Type | Required | Description |
|---|---|---|---|
topic |
string | Yes | What the post is about. |
platform |
string | No | Target platform, for example linkedin, twitter or instagram. Defaults to linkedin. |
length |
string | No | short (about 100 words), medium (about 200) or long (about 400). Defaults to medium. |
anchors |
string[] | No | Personal experiences or themes to weave in. |
Returns post, platform and word_count.
respond_as_me
Drafts a reply to a message in your voice, using what your AI knows about you and the people you work with.
| Parameter | Type | Required | Description |
|---|---|---|---|
message |
string | Yes | The message to reply to. |
channel |
string | No | Where the reply goes, for example email, slack or text. Defaults to email. |
intent |
string | No | What the reply should achieve. |
Returns response and channel.
decide
Weighs options against your values, goals and past decisions, and returns a decision with its reasoning.
| Parameter | Type | Required | Description |
|---|---|---|---|
situation |
string | Yes | The decision to make. |
options |
string[] | Yes | The options to choose from. |
Returns decision.
refuse
Checks, without doing anything, whether a request fits your values. Agents can call it before an action tool.
| Parameter | Type | Required | Description |
|---|---|---|---|
request |
string | Yes | What's being asked. |
Returns would_refuse (a boolean) and reason.
act
Asks your AI to do something through the apps you've connected in uare.ai, such as Gmail or Google Drive. Your AI picks the app and the action itself.
- Reads (search, fetch, list) run right away.
- Writes (send, create, delete) don't run here. Your AI returns a plan in
pending_actions, with aconfirmation_tokenyou pass toconfirm_action.
| Parameter | Type | Required | Description |
|---|---|---|---|
intent |
string | Yes | What you want done, for example "check my latest emails from my accountant". |
Returns response, plus pending_actions when a write is waiting for confirmation.
confirm_action
Carries out a write that act staged. A token works once and expires about 10 minutes after act returned it.
| Parameter | Type | Required | Description |
|---|---|---|---|
confirmation_token |
string | Yes | The token from act's pending_actions. |
Returns executed, actions and result.
learn
Queues a new fact about you for your AI's knowledge. The fact is reviewed before it becomes part of what your AI knows.
| Parameter | Type | Required | Description |
|---|---|---|---|
content |
string | Yes | The fact, in plain language. Up to 2,000 characters. |
dimension |
string | Yes | One of identity, world, story, mindset, drive, pattern or growth. |
confidence |
number | No | How sure you are, from 0 to 1. Defaults to 0.7. |
Returns pending_fact_id and status: pending_approval when the fact is waiting for review, or queued_locally when uare.ai couldn't queue it yet and retries in the background.
list_skills
Lists your skills and preferences: the markdown files you write to guide your AI. No parameters.
Returns a list of entries with name, type (skill or preference), a short preview and size in bytes. An entry with hidden: true is a learned skill your AI doesn't use: its preview reads [hidden], and get_skill won't return it.
get_skill
Returns one skill or preference in full, including its YAML frontmatter.
| Parameter | Type | Required | Description |
|---|---|---|---|
name |
string | Yes | The name from list_skills. |
Returns name, content and type (skill or preference). Preferences are rules your AI always applies to itself; reading one tells an agent what your AI is working under.