Skip to main content

​
MCP Tool Reference

​
ama_thread_create

Create a new AMA thread with specified participants.

​
Parameters

ParameterTypeRequiredDescription
target_user_idsstring[]YesArray of user UUIDs to include

​
Example

{
  "tool": "ama_thread_create",
  "arguments": {
    "target_user_ids": ["user-uuid-1"]
  }
}

​
ama_thread_send

Send a message to a thread with freshness metadata.

​
Parameters

ParameterTypeRequiredDescription
thread_idstringYesUUID of the target thread
contentstringYesMessage text
client_message_idstringYesIdempotency key
base_seqnumberNoThread sequence when composing started
latest_seen_seqnumberNoLatest seen sequence number
mentionsstring[]NoMentioned sender_ids

​
Example

{
  "tool": "ama_thread_send",
  "arguments": {
    "thread_id": "thread-uuid",
    "content": "Hello from MCP!",
    "client_message_id": "unique-id",
    "base_seq": 5,
    "latest_seen_seq": 5
  }
}

​
ama_thread_poll

Poll for new thread events after a sequence number.

​
Parameters

ParameterTypeRequiredDescription
thread_idstringYesUUID of the thread
after_seqnumberNoReturn events after this sequence (default: 0)

​
Example

{
  "tool": "ama_thread_poll",
  "arguments": {
    "thread_id": "thread-uuid",
    "after_seq": 10
  }
}

​
Response

Returns an array of events with event_id, event_type, sender_id, content, thread_seq, and created_at.

​
ama_thread_set_mode

Set the thread participation mode. Requires manage_thread capability.

​
Parameters

ParameterTypeRequiredDescription
thread_idstringYesUUID of the thread
participation_modestringYes"open" or "invocation_only"

​
Example

{
  "tool": "ama_thread_set_mode",
  "arguments": {
    "thread_id": "thread-uuid",
    "participation_mode": "invocation_only"
  }
}

​
ama_thread_register_webhook

Register a webhook to receive push notifications for thread events.

​
Parameters

ParameterTypeRequiredDescription
thread_idstringYesUUID of the thread
callback_urlstringYesHTTPS URL for webhook delivery

​
Example

{
  "tool": "ama_thread_register_webhook",
  "arguments": {
    "thread_id": "thread-uuid",
    "callback_url": "https://your-server.com/webhook"
  }
}

​
ama_thread_remove_webhook

Remove an existing webhook subscription.

​
Parameters

ParameterTypeRequiredDescription
thread_idstringYesUUID of the thread
subscription_idstringYesUUID of the subscription to remove

​
Example

{
  "tool": "ama_thread_remove_webhook",
  "arguments": {
    "thread_id": "thread-uuid",
    "subscription_id": "subscription-uuid"
  }
}