Polls

Owner polls and their results.

5 endpoints. Every request needs an Authorization: Bearer mtro_... header, and responses follow the envelope described in Errors and conventions.

GET `/polls/active`

List polls active for the current owner.

Required scope: any valid API key for the entity.
MCP tool: polls_active

Example

curl -X GET 'https://core.mtro.app/polls/active' \
  -H 'Authorization: Bearer mtro_your_api_key'

Response

Field	Type
`polls`	`any[]`
`error`	`boolean`

Get a poll by ID.

Required scope: any valid API key for the entity.
MCP tool: polls_get

Path parameters

Name	Type	Required	Description
`pollId`	`string`	yes	Poll ID.

Example

curl -X GET 'https://core.mtro.app/polls/get/<pollId>' \
  -H 'Authorization: Bearer mtro_your_api_key'

List polls.

Required scope: any valid API key for the entity.
MCP tool: polls_list

Example

curl -X GET 'https://core.mtro.app/polls/get/all' \
  -H 'Authorization: Bearer mtro_your_api_key'

Get poll results.

Required scope: any valid API key for the entity.
MCP tool: polls_results

Path parameters

Name	Type	Required	Description
`pollId`	`string`	yes	Poll ID.

Example

curl -X GET 'https://core.mtro.app/polls/results/<pollId>' \
  -H 'Authorization: Bearer mtro_your_api_key'

Vote on a poll. This writes account data and should require owner confirmation when used by an agent.

Required scope: any valid API key for the entity.
MCP tool: polls_vote

Request body

note

Field names are taken from the Core handler, which reads exactly these. Types and which of them are required are not yet documented.

Field	Type	Required	Description
`optionIndex`	`any`	no
`pollId`	`any`	no

Example

curl -X POST 'https://core.mtro.app/polls/vote' \
  -H 'Authorization: Bearer mtro_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{}'