Menu

Mattering Agents MCP tools

5 tools on the Mattering MCP gateway at https://mcp.mattering.io/mcp. Each call reaches the Agents service tier with your identity in headers, so a tool sees exactly what you can see in the app.

Connect any MCP client to https://mcp.mattering.io/mcp; it discovers the Mattering sign-in and asks you to approve the tools it may use. Tool names, parameters and descriptions below are read from the gateway source. See the MCP gateway concept page for connection details.

Agents

matter_get_agent

Get one agent by its public id (from matter_list_agents).

Full description

Get one agent by its public id (from matter_list_agents).

Required: agent_id. Returns its configuration: name, description, status, model, workspace, system prompt and personality, steps per run (max_turns), tool and connector scope, grants, knowledge sources and skills.

Parameters

NameTypeRequiredDefault
agent_idstrrequirednone

Calls

  • GET{path}/

matter_list_agents

List the agents you can use or manage.

Full description

List the agents you can use or manage.

Optional: workspace_id (a workspace's agents plus unbound ones), status (active | draft | paused), limit (default 50, max 200), offset. Returns ``{data: [agent...], meta: {total, limit, offset, has_more}}; each agent carries its public id`` for the other matter_* tools.

Parameters

NameTypeRequiredDefault
workspace_idOptional[str]optionalnone
statusOptional[str]optionalnone
limitintoptional50
offsetintoptional0

Calls

  • GET/agents/

Runs

matter_list_runs

List one agent's runs, newest first: chat, scheduled, triggered and call runs.

Full description

List one agent's runs, newest first: chat, scheduled, triggered and call runs.

Required: agent_id. Optional: limit (default 50, max 200), offset. Each run has its trigger, status, start/finish time and cost.

Parameters

NameTypeRequiredDefault
agent_idstrrequirednone
limitintoptional50
offsetintoptional0

Calls

  • GET{path}/runs/

Schedules

matter_list_schedules

List one agent's schedules: recurring routines and one-off tasks.

Full description

List one agent's schedules: recurring routines and one-off tasks.

Required: agent_id. Optional: limit (default 50, max 200), offset. Each schedule has name, prompt (what the agent is asked to do), status (active | paused | done | error | expired), timezone, either cron_expression (recurring) or run_at (one-off), and next_fire_at (UTC). For a day-by-day view use matter_query_schedule_calendar.

Parameters

NameTypeRequiredDefault
agent_idstrrequirednone
limitintoptional50
offsetintoptional0

Calls

  • GET{path}/schedules/

matter_query_schedule_calendar

Agents' schedules as calendar occurrences over a date range.

Full description

Agents' schedules as calendar occurrences over a date range.

Optional: start and end (ISO 8601 dates or datetimes, UTC if no offset; default: today for 7 days; max range 62 days), agent_id (one agent; otherwise every agent you can see), workspace_id (with no agent_id: that workspace's agents plus unbound ones), collapse (default true: a routine firing more than 6 times a day becomes one all-day entry per day).

Each occurrence: name, start/end (UTC), all_day, kind (one-off | recurring), state (scheduled | paused | ran | failed), summary, timezone, agent. Past recurring entries are the runs that actually happened; future ones are projected.

Parameters

NameTypeRequiredDefault
startOptional[str]optionalnone
endOptional[str]optionalnone
agent_idOptional[str]optionalnone
workspace_idOptional[str]optionalnone
collapsebooloptionalTrue

Calls

  • GET/calendar/
  • GET{path}/calendar/

Identity tools (every app)

The gateway registers these once, outside any app family. Call whoami first when a result looks empty.

auth_statusReport token health, expiry, bound principal, and catalog version.
get_accountReturn the current user's account profile (email, name, id).
get_organizationReturn the organization this session is currently acting as.
list_organizationsList every organization the authenticated identity belongs to.
reauthenticateExplain how to refresh this connection's authentication.
switch_accountExplain how to re-authenticate as a different account / org.
whoamiShow who this MCP session is authenticated as.
Start Free Explore our Products