API Reference

Manage Agency Agent / MCP HTTP API

Every capability your agency has in the dashboard, exposed as a single bearer-token HTTP endpoint and a first-party MCP server. Mint a token at /settings/api-tokens, set MA_TOKEN, and the examples below run as-is.

Endpoints

GET/api/agent/read

Read resources scoped to your token's org. REST-style.

Scope: agent:read

POST/api/agent/action

Run a write capability. Same handlers as the dashboard tool palette.

Scope: agent:write

POST/api/mcp

JSON-RPC 2.0 over HTTP — the MCP transport. Streamable, hosted at the same origin.

Scope: agent:read + agent:write

GET/api/agent/capabilities

Machine-readable catalogue of every verb + its input schema (mirrors this page).

Scope: agent:read

Rate-limited: agent.read 240/min · agent.action 60/min · token mint 10/hr. Auto-throttled with Retry-After headers.

Install

Manage Agency speaks MCP over Streamable HTTP. No mcp-remote bridge required. Mint a token at /settings/api-tokens, then paste one of these snippets.

Claude Desktop

json

Drop into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "manage-agency": {
      "url": "https://manageagency.app/api/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

Cursor / Continue / any MCP client

json

Identical config — same shape: URL + transport + Authorization header. Or pass the JSON via your client's settings UI.

{
  "manage-agency": {
    "url": "https://manageagency.app/api/mcp",
    "transport": "streamable-http",
    "headers": {
      "Authorization": "Bearer <YOUR_TOKEN>"
    }
  }
}

n8n / Zapier / any HTTP node

bash

Skip MCP, hit the REST endpoints directly. Standard Bearer auth — works in any tool that speaks HTTP.

# List clients
curl -s "https://manageagency.app/api/agent/read?resource=clients" \
  -H "Authorization: Bearer $MA_TOKEN"

# Move a lead to "won"
curl -s -X POST https://manageagency.app/api/agent/action \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"move_pipeline_stage","input":{"lead_id":"<LEAD_ID>","stage":"won"}}'

Smoke test

bash

After config, run this to verify the MCP transport can see every tool:

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | jq '.result.tools[].name'

Credits

Every call spends credits against the org's monthly allowance (then top-up balance). Per-org pricing overrides are supported; defaults below.

agent.read

1 cr

agent.action

5 cr

tool.run

5 cr

ai.generation

10 cr

Read resources

GET /api/agent/read?resource=<name>&client_id=<optional>&limit=50

clientsagent:read

All clients in the caller's org. Filter with `client_id` to drill into one.

projectsagent:read

All projects in the org. Returns id, client_id, name, status, priority, due_date.

eventsagent:read

Calendar events (meetings, calls, deadlines) keyed by client_id.

deliverablesagent:read

Deliverables — joined through projects.org_id since the table itself has no org_id.

notification-logsagent:read

Audit trail for outbound email + Slack notifications.

report-summariesagent:read

Per-client wins / risks / next-focus narratives feeding the client portal report.

leadsagent:read

CRM pipeline — name, company, stage, deal value, next action. Stage transitions go through `move_pipeline_stage`.

invoicesagent:read

Invoices with status, total, currency, due / sent / paid timestamps.

contractsagent:read

Agreements with status (draft / sent / viewed / signed / expired).

Write capabilities

JSON-RPC tools/call with the capability name and a typed arguments object. Same handlers power the dashboard tool palette.

Reporting

2 verbs

update_report_summary

Update report summary

write

Upsert the wins / risks / next focus narrative + KPI cards for a client. Surfaces immediately on their portal report.

Arguments

`client_id`*	client-id	Client
`wins`	textarea	Wins
`risks`	textarea	Risks
`next_focus`	textarea	Next focus
`owner_name`	text	Report owner

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_report_summary",
    "arguments": {
      "client_id": "<CLIENT_ID>"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"update_report_summary","arguments":{"client_id":"<CLIENT_ID>"}}}'

generate_report

Generate report draft

write

Assemble a wins / risks / next-focus report draft for a client from concrete account state — recently shipped deliverables, revision requests, overdue projects + invoices, active projects, upcoming events. Deterministic, no AI. Pass dry_run to preview without saving; otherwise it upserts the report summary.

Arguments

`client_id`*	client-id	Client
`period_days`	text	7–90. Defaults to 30.
`dry_run`	select	Preview returns the draft without touching the saved report.one of: / true

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "generate_report",
    "arguments": {
      "client_id": "<CLIENT_ID>",
      "dry_run": ""
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"generate_report","arguments":{"client_id":"<CLIENT_ID>","dry_run":""}}}'

Operations

9 verbs

add_event

Schedule client event

write

Add a meeting, deadline, milestone, or reminder to a client's calendar. Shows up on the agency calendar + portal events list.

Arguments

`client_id`*	client-id	Client
`title`*	text	Title
`start_at`*	date	Start time
`end_at`	date	End time
`meeting_link`	text	Meeting link
`description`	textarea	Description

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "add_event",
    "arguments": {
      "client_id": "<CLIENT_ID>",
      "title": "Weekly review call",
      "start_at": "2026-07-14T10:34:45.774Z",
      "end_at": "2026-07-14T10:34:45.774Z"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"add_event","arguments":{"client_id":"<CLIENT_ID>","title":"Weekly review call","start_at":"2026-07-14T10:34:45.774Z","end_at":"2026-07-14T10:34:45.774Z"}}}'

create_deliverable

Create deliverable

write

Add a new deliverable to an existing project. Optionally attach a file URL (e.g. a hosted asset the agent just produced). Status defaults to draft.

Arguments

`project_id`*	project-id	Project UUID. Use agent_read with resource="projects" to list.
`title`*	text	Title
`description`	textarea	Description
`status`	text	Defaults to draft.
`due_date`	date	Due date
`file_url`	text	File URL
`file_name`	text	File name

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_deliverable",
    "arguments": {
      "project_id": "<PROJECT_ID>",
      "title": "Week 3 launch creative pack",
      "due_date": "2026-07-14T10:34:45.776Z"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"create_deliverable","arguments":{"project_id":"<PROJECT_ID>","title":"Week 3 launch creative pack","due_date":"2026-07-14T10:34:45.776Z"}}}'

set_deliverable_status

Set deliverable status

write

Move a deliverable through the lifecycle: draft → in_progress → review → revision → approved → delivered. Idempotent — same status is a no-op.

Arguments

`deliverable_id`*	deliverable-id	Use agent_read with resource="deliverables" to list.
`status`*	select	Setting to "approved" also fires the deliverable.approved audit event.one of: draft / in_progress / review / revision / approved / delivered

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "set_deliverable_status",
    "arguments": {
      "deliverable_id": "<DELIVERABLE_ID>",
      "status": "draft"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"set_deliverable_status","arguments":{"deliverable_id":"<DELIVERABLE_ID>","status":"draft"}}}'

set_project_status

Set project status

write

Progress a project through the lifecycle: not_started → in_progress → review → on_hold → completed. Idempotent — same status is a no-op.

Arguments

`project_id`*	project-id	Project
`status`*	select	New statusone of: not_started / in_progress / review / on_hold / completed

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "set_project_status",
    "arguments": {
      "project_id": "<PROJECT_ID>",
      "status": "not_started"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"set_project_status","arguments":{"project_id":"<PROJECT_ID>","status":"not_started"}}}'

update_project

Update project

write

Edit a project's name, priority, due date, or description. Any field omitted is left untouched. Status is changed separately via set_project_status.

Arguments

`project_id`*	project-id	Project
`name`	text	Name
`priority`	select	Priorityone of: low / medium / high
`due_date`	date	Due date
`description`	textarea	Description

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_project",
    "arguments": {
      "project_id": "<PROJECT_ID>",
      "priority": "low",
      "due_date": "2026-07-14T10:34:45.776Z"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"update_project","arguments":{"project_id":"<PROJECT_ID>","priority":"low","due_date":"2026-07-14T10:34:45.776Z"}}}'

delete_deliverable

Delete deliverable

write

Remove a deliverable from a project. Refuses approved or delivered deliverables (move them to revision first if they need replacing). Audits with title + status + reason so the audit trail captures what was removed.

Arguments

`deliverable_id`*	deliverable-id	Deliverable
`reason`	text	Reason (optional)

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "delete_deliverable",
    "arguments": {
      "deliverable_id": "<DELIVERABLE_ID>"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"delete_deliverable","arguments":{"deliverable_id":"<DELIVERABLE_ID>"}}}'

set_onboarding_step_status

Set onboarding step status

write

Progress a client onboarding step: pending → in_progress → completed → skipped. Stamps completed_at when finished, clears it if a step is reopened. Idempotent.

Arguments

`step_id`*	onboarding-step-id	Onboarding step
`status`*	select	New statusone of: pending / in_progress / completed / skipped

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "set_onboarding_step_status",
    "arguments": {
      "status": "pending"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"set_onboarding_step_status","arguments":{"status":"pending"}}}'

send_contract

Send contract

write

Move a contract from draft to sent, stamp sent_at, and email all client portal contacts. Idempotent — sent/viewed/signed contracts return unchanged.

Arguments

contract_id* contract-id Contract

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "send_contract",
    "arguments": {
      "contract_id": "<CONTRACT_ID>"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"send_contract","arguments":{"contract_id":"<CONTRACT_ID>"}}}'

mark_contract_signed

Mark contract signed

write

Manually record a contract signing that happened off-platform (DocuSign, wet signature, etc.). Sets status to signed, stamps signed_at, and emails the agency owner. Idempotent.

Arguments

`contract_id`*	contract-id	Contract
`signer_name`	text	Signer name
`note`	text	Note

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mark_contract_signed",
    "arguments": {
      "contract_id": "<CONTRACT_ID>"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"mark_contract_signed","arguments":{"contract_id":"<CONTRACT_ID>"}}}'

Billing

3 verbs

generate_invoice_payment_link

Send invoice (mint payment link)

write

Mint a Stripe Payment Link for an invoice, mark it sent, and email it to the client. Idempotent — returns the existing link if one is already on the invoice.

Arguments

invoice_id* invoice-id Invoice

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "generate_invoice_payment_link",
    "arguments": {
      "invoice_id": "<INVOICE_ID>"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"generate_invoice_payment_link","arguments":{"invoice_id":"<INVOICE_ID>"}}}'

mark_invoice_paid

Mark invoice paid

write

Manually reconcile an invoice that was paid off-platform (wire, cash, alt-rail). Sets status to paid, stamps paid_at, and emails the agency owner. Idempotent.

Arguments

`invoice_id`*	invoice-id	Invoice
`note`	text	Note

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mark_invoice_paid",
    "arguments": {
      "invoice_id": "<INVOICE_ID>"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"mark_invoice_paid","arguments":{"invoice_id":"<INVOICE_ID>"}}}'

set_invoice_due_date

Set invoice due date

write

Reschedule an invoice's due_date (or clear it by passing an empty string). Refuses paid/void invoices. Audits as invoice.sent with the old/new dates in metadata.

Arguments

`invoice_id`*	invoice-id	Invoice
`due_date`*	date	Empty string clears the due date.

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "set_invoice_due_date",
    "arguments": {
      "invoice_id": "<INVOICE_ID>",
      "due_date": "2026-07-14T10:34:45.777Z"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"set_invoice_due_date","arguments":{"invoice_id":"<INVOICE_ID>","due_date":"2026-07-14T10:34:45.777Z"}}}'

CRM

6 verbs

move_pipeline_stage

Move pipeline stage

write

Progress a CRM lead through pipeline: lead → discovery → proposal → negotiation → won → lost. Auto-stamps won_at / lost_at when transitioning to terminal stages.

Arguments

`lead_id`*	lead-id	Lead
`stage`*	select	New stageone of: lead / discovery / proposal / negotiation / won / lost
`next_action`	text	Next action (optional)

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "move_pipeline_stage",
    "arguments": {
      "lead_id": "<LEAD_ID>",
      "stage": "lead"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"move_pipeline_stage","arguments":{"lead_id":"<LEAD_ID>","stage":"lead"}}}'

update_client

Update client

write

Edit a client's name, company, status, industry, or website. Omitted fields are left untouched. Use this to mark a client paused/churned/archived from an automation.

Arguments

`client_id`*	client-id	Client
`name`	text	Display name
`company_name`	text	Company name
`status`	select	Statusone of: onboarding / active / paused / past
`industry`	text	Industry
`website`	text	Website

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_client",
    "arguments": {
      "client_id": "<CLIENT_ID>",
      "status": "onboarding"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"update_client","arguments":{"client_id":"<CLIENT_ID>","status":"onboarding"}}}'

delete_lead

Delete lead

write

Remove a lead from the CRM. Refuses leads already converted to a client (delete or update the client first). Audits with name + final stage + reason so the audit trail remembers what was deleted.

Arguments

`lead_id`*	lead-id	Lead
`reason`	text	Reason (optional)

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "delete_lead",
    "arguments": {
      "lead_id": "<LEAD_ID>"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"delete_lead","arguments":{"lead_id":"<LEAD_ID>"}}}'

convert_lead_to_client

Convert lead → client

write

Spin up a new client record from a won deal. Creates the client (status: onboarding), sets the lead's client_id, and marks the lead won. Defaults client name/company/email to the lead's own fields when omitted.

Arguments

`lead_id`*	lead-id	Lead
`client_name`	text	Client display name (optional)
`company_name`	text	Company (optional)
`primary_contact_email`	text	Primary contact email (optional)

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "convert_lead_to_client",
    "arguments": {
      "lead_id": "<LEAD_ID>"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"convert_lead_to_client","arguments":{"lead_id":"<LEAD_ID>"}}}'

post_client_message

Post message in client portal

write

Post an agency-side message in the client's general portal conversation. Creates the conversation if it doesn't exist yet. Triggers the client-message email with reply-to-thread routing.

Arguments

`client_id`*	client-id	Client
`content`*	textarea	Max 8000 chars.
`title`	text	Thread title (new threads only)

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "post_client_message",
    "arguments": {
      "client_id": "<CLIENT_ID>",
      "content": "Quick update on the brand refresh…"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"post_client_message","arguments":{"client_id":"<CLIENT_ID>","content":"Quick update on the brand refresh…"}}}'

add_client_note

Add client note

write

Drop a free-form note on a client's record. Shows up immediately on the client overview timeline. Use it to capture call summaries, research, intel, or anything an agent learns mid-workflow.

Arguments

`client_id`*	client-id	Client
`body`*	textarea	Max 4000 characters.
`category`	select	Optional — leave blank for an uncategorised note.one of: general / sales / delivery / risk / win / admin

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "add_client_note",
    "arguments": {
      "client_id": "<CLIENT_ID>",
      "body": "What did you learn or want the team to see?",
      "category": "general"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"add_client_note","arguments":{"client_id":"<CLIENT_ID>","body":"What did you learn or want the team to see?","category":"general"}}}'

Calendar

2 verbs

reschedule_event

Reschedule event

write

Move an existing calendar event to a new start (and optionally end / meeting link). Pass an empty string for end_at to clear it. Audits with old/new times.

Arguments

`event_id`*	event-id	Event
`start_at`*	date	New start
`end_at`	date	Empty string clears the end time.
`meeting_link`	text	Meeting link (optional)

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reschedule_event",
    "arguments": {
      "event_id": "<EVENT_ID>",
      "start_at": "2026-07-14T10:34:45.775Z",
      "end_at": "2026-07-14T10:34:45.775Z"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"reschedule_event","arguments":{"event_id":"<EVENT_ID>","start_at":"2026-07-14T10:34:45.775Z","end_at":"2026-07-14T10:34:45.775Z"}}}'

cancel_event

Cancel event

write

Cancel (delete) a calendar event. Logs the cancellation with the reason so the timeline shows what was cancelled and why.

Arguments

`event_id`*	event-id	Event
`reason`	text	Reason (optional)

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "cancel_event",
    "arguments": {
      "event_id": "<EVENT_ID>"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"cancel_event","arguments":{"event_id":"<EVENT_ID>"}}}'

Build with this

The fastest path: configure the MCP server in Claude Desktop, n8n, or Cursor and let the model call these tools directly. The full catalogue is also available as JSON at /api/agent/capabilities for codegen.

Mint a token →See pricing

API Reference

Manage Agency Agent / MCP HTTP API

Endpoints

GET/api/agent/read

Read resources scoped to your token's org. REST-style.

Scope: agent:read

POST/api/agent/action

Run a write capability. Same handlers as the dashboard tool palette.

Scope: agent:write

POST/api/mcp

JSON-RPC 2.0 over HTTP — the MCP transport. Streamable, hosted at the same origin.

Scope: agent:read + agent:write

GET/api/agent/capabilities

Machine-readable catalogue of every verb + its input schema (mirrors this page).

Scope: agent:read

Rate-limited: agent.read 240/min · agent.action 60/min · token mint 10/hr. Auto-throttled with Retry-After headers.

Install

Manage Agency speaks MCP over Streamable HTTP. No mcp-remote bridge required. Mint a token at /settings/api-tokens, then paste one of these snippets.

Claude Desktop

json

Drop into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "manage-agency": {
      "url": "https://manageagency.app/api/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

Cursor / Continue / any MCP client

json

Identical config — same shape: URL + transport + Authorization header. Or pass the JSON via your client's settings UI.

{
  "manage-agency": {
    "url": "https://manageagency.app/api/mcp",
    "transport": "streamable-http",
    "headers": {
      "Authorization": "Bearer <YOUR_TOKEN>"
    }
  }
}

n8n / Zapier / any HTTP node

bash

Skip MCP, hit the REST endpoints directly. Standard Bearer auth — works in any tool that speaks HTTP.

# List clients
curl -s "https://manageagency.app/api/agent/read?resource=clients" \
  -H "Authorization: Bearer $MA_TOKEN"

# Move a lead to "won"
curl -s -X POST https://manageagency.app/api/agent/action \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"move_pipeline_stage","input":{"lead_id":"<LEAD_ID>","stage":"won"}}'

Smoke test

bash

After config, run this to verify the MCP transport can see every tool:

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | jq '.result.tools[].name'

Credits

Every call spends credits against the org's monthly allowance (then top-up balance). Per-org pricing overrides are supported; defaults below.

agent.read

1 cr

agent.action

5 cr

tool.run

5 cr

ai.generation

10 cr

Read resources

GET /api/agent/read?resource=<name>&client_id=<optional>&limit=50

clientsagent:read

All clients in the caller's org. Filter with `client_id` to drill into one.

projectsagent:read

All projects in the org. Returns id, client_id, name, status, priority, due_date.

eventsagent:read

Calendar events (meetings, calls, deadlines) keyed by client_id.

deliverablesagent:read

Deliverables — joined through projects.org_id since the table itself has no org_id.

notification-logsagent:read

Audit trail for outbound email + Slack notifications.

report-summariesagent:read

Per-client wins / risks / next-focus narratives feeding the client portal report.

leadsagent:read

CRM pipeline — name, company, stage, deal value, next action. Stage transitions go through `move_pipeline_stage`.

invoicesagent:read

Invoices with status, total, currency, due / sent / paid timestamps.

contractsagent:read

Agreements with status (draft / sent / viewed / signed / expired).

Write capabilities

JSON-RPC tools/call with the capability name and a typed arguments object. Same handlers power the dashboard tool palette.

Reporting

2 verbs

update_report_summary

Update report summary

write

Upsert the wins / risks / next focus narrative + KPI cards for a client. Surfaces immediately on their portal report.

Arguments

`client_id`*	client-id	Client
`wins`	textarea	Wins
`risks`	textarea	Risks
`next_focus`	textarea	Next focus
`owner_name`	text	Report owner

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_report_summary",
    "arguments": {
      "client_id": "<CLIENT_ID>"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"update_report_summary","arguments":{"client_id":"<CLIENT_ID>"}}}'

generate_report

Generate report draft

write

Arguments

`client_id`*	client-id	Client
`period_days`	text	7–90. Defaults to 30.
`dry_run`	select	Preview returns the draft without touching the saved report.one of: / true

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "generate_report",
    "arguments": {
      "client_id": "<CLIENT_ID>",
      "dry_run": ""
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"generate_report","arguments":{"client_id":"<CLIENT_ID>","dry_run":""}}}'

Operations

9 verbs

add_event

Schedule client event

write

Add a meeting, deadline, milestone, or reminder to a client's calendar. Shows up on the agency calendar + portal events list.

Arguments

`client_id`*	client-id	Client
`title`*	text	Title
`start_at`*	date	Start time
`end_at`	date	End time
`meeting_link`	text	Meeting link
`description`	textarea	Description

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "add_event",
    "arguments": {
      "client_id": "<CLIENT_ID>",
      "title": "Weekly review call",
      "start_at": "2026-07-14T10:34:45.774Z",
      "end_at": "2026-07-14T10:34:45.774Z"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"add_event","arguments":{"client_id":"<CLIENT_ID>","title":"Weekly review call","start_at":"2026-07-14T10:34:45.774Z","end_at":"2026-07-14T10:34:45.774Z"}}}'

create_deliverable

Create deliverable

write

Add a new deliverable to an existing project. Optionally attach a file URL (e.g. a hosted asset the agent just produced). Status defaults to draft.

Arguments

`project_id`*	project-id	Project UUID. Use agent_read with resource="projects" to list.
`title`*	text	Title
`description`	textarea	Description
`status`	text	Defaults to draft.
`due_date`	date	Due date
`file_url`	text	File URL
`file_name`	text	File name

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_deliverable",
    "arguments": {
      "project_id": "<PROJECT_ID>",
      "title": "Week 3 launch creative pack",
      "due_date": "2026-07-14T10:34:45.776Z"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"create_deliverable","arguments":{"project_id":"<PROJECT_ID>","title":"Week 3 launch creative pack","due_date":"2026-07-14T10:34:45.776Z"}}}'

set_deliverable_status

Set deliverable status

write

Move a deliverable through the lifecycle: draft → in_progress → review → revision → approved → delivered. Idempotent — same status is a no-op.

Arguments

`deliverable_id`*	deliverable-id	Use agent_read with resource="deliverables" to list.
`status`*	select	Setting to "approved" also fires the deliverable.approved audit event.one of: draft / in_progress / review / revision / approved / delivered

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "set_deliverable_status",
    "arguments": {
      "deliverable_id": "<DELIVERABLE_ID>",
      "status": "draft"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"set_deliverable_status","arguments":{"deliverable_id":"<DELIVERABLE_ID>","status":"draft"}}}'

set_project_status

Set project status

write

Progress a project through the lifecycle: not_started → in_progress → review → on_hold → completed. Idempotent — same status is a no-op.

Arguments

`project_id`*	project-id	Project
`status`*	select	New statusone of: not_started / in_progress / review / on_hold / completed

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "set_project_status",
    "arguments": {
      "project_id": "<PROJECT_ID>",
      "status": "not_started"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"set_project_status","arguments":{"project_id":"<PROJECT_ID>","status":"not_started"}}}'

update_project

Update project

write

Edit a project's name, priority, due date, or description. Any field omitted is left untouched. Status is changed separately via set_project_status.

Arguments

`project_id`*	project-id	Project
`name`	text	Name
`priority`	select	Priorityone of: low / medium / high
`due_date`	date	Due date
`description`	textarea	Description

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_project",
    "arguments": {
      "project_id": "<PROJECT_ID>",
      "priority": "low",
      "due_date": "2026-07-14T10:34:45.776Z"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"update_project","arguments":{"project_id":"<PROJECT_ID>","priority":"low","due_date":"2026-07-14T10:34:45.776Z"}}}'

delete_deliverable

Delete deliverable

write

Arguments

`deliverable_id`*	deliverable-id	Deliverable
`reason`	text	Reason (optional)

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "delete_deliverable",
    "arguments": {
      "deliverable_id": "<DELIVERABLE_ID>"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"delete_deliverable","arguments":{"deliverable_id":"<DELIVERABLE_ID>"}}}'

set_onboarding_step_status

Set onboarding step status

write

Progress a client onboarding step: pending → in_progress → completed → skipped. Stamps completed_at when finished, clears it if a step is reopened. Idempotent.

Arguments

`step_id`*	onboarding-step-id	Onboarding step
`status`*	select	New statusone of: pending / in_progress / completed / skipped

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "set_onboarding_step_status",
    "arguments": {
      "status": "pending"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"set_onboarding_step_status","arguments":{"status":"pending"}}}'

send_contract

Send contract

write

Move a contract from draft to sent, stamp sent_at, and email all client portal contacts. Idempotent — sent/viewed/signed contracts return unchanged.

Arguments

contract_id* contract-id Contract

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "send_contract",
    "arguments": {
      "contract_id": "<CONTRACT_ID>"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"send_contract","arguments":{"contract_id":"<CONTRACT_ID>"}}}'

mark_contract_signed

Mark contract signed

write

Manually record a contract signing that happened off-platform (DocuSign, wet signature, etc.). Sets status to signed, stamps signed_at, and emails the agency owner. Idempotent.

Arguments

`contract_id`*	contract-id	Contract
`signer_name`	text	Signer name
`note`	text	Note

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mark_contract_signed",
    "arguments": {
      "contract_id": "<CONTRACT_ID>"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"mark_contract_signed","arguments":{"contract_id":"<CONTRACT_ID>"}}}'

Billing

3 verbs

generate_invoice_payment_link

Send invoice (mint payment link)

write

Mint a Stripe Payment Link for an invoice, mark it sent, and email it to the client. Idempotent — returns the existing link if one is already on the invoice.

Arguments

invoice_id* invoice-id Invoice

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "generate_invoice_payment_link",
    "arguments": {
      "invoice_id": "<INVOICE_ID>"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"generate_invoice_payment_link","arguments":{"invoice_id":"<INVOICE_ID>"}}}'

mark_invoice_paid

Mark invoice paid

write

Manually reconcile an invoice that was paid off-platform (wire, cash, alt-rail). Sets status to paid, stamps paid_at, and emails the agency owner. Idempotent.

Arguments

`invoice_id`*	invoice-id	Invoice
`note`	text	Note

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mark_invoice_paid",
    "arguments": {
      "invoice_id": "<INVOICE_ID>"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"mark_invoice_paid","arguments":{"invoice_id":"<INVOICE_ID>"}}}'

set_invoice_due_date

Set invoice due date

write

Reschedule an invoice's due_date (or clear it by passing an empty string). Refuses paid/void invoices. Audits as invoice.sent with the old/new dates in metadata.

Arguments

`invoice_id`*	invoice-id	Invoice
`due_date`*	date	Empty string clears the due date.

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "set_invoice_due_date",
    "arguments": {
      "invoice_id": "<INVOICE_ID>",
      "due_date": "2026-07-14T10:34:45.777Z"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"set_invoice_due_date","arguments":{"invoice_id":"<INVOICE_ID>","due_date":"2026-07-14T10:34:45.777Z"}}}'

CRM

6 verbs

move_pipeline_stage

Move pipeline stage

write

Progress a CRM lead through pipeline: lead → discovery → proposal → negotiation → won → lost. Auto-stamps won_at / lost_at when transitioning to terminal stages.

Arguments

`lead_id`*	lead-id	Lead
`stage`*	select	New stageone of: lead / discovery / proposal / negotiation / won / lost
`next_action`	text	Next action (optional)

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "move_pipeline_stage",
    "arguments": {
      "lead_id": "<LEAD_ID>",
      "stage": "lead"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"move_pipeline_stage","arguments":{"lead_id":"<LEAD_ID>","stage":"lead"}}}'

update_client

Update client

write

Edit a client's name, company, status, industry, or website. Omitted fields are left untouched. Use this to mark a client paused/churned/archived from an automation.

Arguments

`client_id`*	client-id	Client
`name`	text	Display name
`company_name`	text	Company name
`status`	select	Statusone of: onboarding / active / paused / past
`industry`	text	Industry
`website`	text	Website

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_client",
    "arguments": {
      "client_id": "<CLIENT_ID>",
      "status": "onboarding"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"update_client","arguments":{"client_id":"<CLIENT_ID>","status":"onboarding"}}}'

delete_lead

Delete lead

write

Remove a lead from the CRM. Refuses leads already converted to a client (delete or update the client first). Audits with name + final stage + reason so the audit trail remembers what was deleted.

Arguments

`lead_id`*	lead-id	Lead
`reason`	text	Reason (optional)

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "delete_lead",
    "arguments": {
      "lead_id": "<LEAD_ID>"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"delete_lead","arguments":{"lead_id":"<LEAD_ID>"}}}'

convert_lead_to_client

Convert lead → client

write

Arguments

`lead_id`*	lead-id	Lead
`client_name`	text	Client display name (optional)
`company_name`	text	Company (optional)
`primary_contact_email`	text	Primary contact email (optional)

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "convert_lead_to_client",
    "arguments": {
      "lead_id": "<LEAD_ID>"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"convert_lead_to_client","arguments":{"lead_id":"<LEAD_ID>"}}}'

post_client_message

Post message in client portal

write

Post an agency-side message in the client's general portal conversation. Creates the conversation if it doesn't exist yet. Triggers the client-message email with reply-to-thread routing.

Arguments

`client_id`*	client-id	Client
`content`*	textarea	Max 8000 chars.
`title`	text	Thread title (new threads only)

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "post_client_message",
    "arguments": {
      "client_id": "<CLIENT_ID>",
      "content": "Quick update on the brand refresh…"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"post_client_message","arguments":{"client_id":"<CLIENT_ID>","content":"Quick update on the brand refresh…"}}}'

add_client_note

Add client note

write

Drop a free-form note on a client's record. Shows up immediately on the client overview timeline. Use it to capture call summaries, research, intel, or anything an agent learns mid-workflow.

Arguments

`client_id`*	client-id	Client
`body`*	textarea	Max 4000 characters.
`category`	select	Optional — leave blank for an uncategorised note.one of: general / sales / delivery / risk / win / admin

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "add_client_note",
    "arguments": {
      "client_id": "<CLIENT_ID>",
      "body": "What did you learn or want the team to see?",
      "category": "general"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"add_client_note","arguments":{"client_id":"<CLIENT_ID>","body":"What did you learn or want the team to see?","category":"general"}}}'

Calendar

2 verbs

reschedule_event

Reschedule event

write

Move an existing calendar event to a new start (and optionally end / meeting link). Pass an empty string for end_at to clear it. Audits with old/new times.

Arguments

`event_id`*	event-id	Event
`start_at`*	date	New start
`end_at`	date	Empty string clears the end time.
`meeting_link`	text	Meeting link (optional)

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reschedule_event",
    "arguments": {
      "event_id": "<EVENT_ID>",
      "start_at": "2026-07-14T10:34:45.775Z",
      "end_at": "2026-07-14T10:34:45.775Z"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"reschedule_event","arguments":{"event_id":"<EVENT_ID>","start_at":"2026-07-14T10:34:45.775Z","end_at":"2026-07-14T10:34:45.775Z"}}}'

cancel_event

Cancel event

write

Cancel (delete) a calendar event. Logs the cancellation with the reason so the timeline shows what was cancelled and why.

Arguments

`event_id`*	event-id	Event
`reason`	text	Reason (optional)

Show JSON-RPC body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "cancel_event",
    "arguments": {
      "event_id": "<EVENT_ID>"
    }
  }
}

Show curl

curl -s -X POST https://manageagency.app/api/mcp \
  -H "Authorization: Bearer $MA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"cancel_event","arguments":{"event_id":"<EVENT_ID>"}}}'

Build with this

Mint a token →See pricing