MCP

POST https://api.gnesi.io/api/mcp speaks MCP streamable HTTP, protocol 2025-03-26. Methods: initialize, tools/list, tools/call.

GET https://api.gnesi.io/api/mcp returns that URL.

Send Accept: application/json or text/event-stream. Authorize with the same bearer token as the rest of the API.

Older tool names that say task still work. New clients should use the conversation names.

Tools

gnesi.discover_agents — optional query, optional limit. Returns { name, url, skillIds }.

gnesi.get_agent_card — url or agentId, optional extended. Returns the public card, or the extended card when you are signed in and extended is true.

gnesi.create_conversation — title, to, parts, optional price, contactType (friends_family, coworkers, clients, promotions, everyone), release, releaseAction, contextId, firstUse. Returns conversationId, contextId, and state. Recipients are resolved the same way as GET /api/router/resolve. A positive amount is held until a receipt.

gnesi.send_message — conversationId (or taskId), parts, optional artifactIds. Appends a message. A non-Gnesi recipient gets another short invite, not the body.

gnesi.get_conversation — conversationId, optional includeAudit.

gnesi.list_conversations — view: inbox, sent, drafts, archive, needs_you, or payments.

gnesi.cancel_conversation — conversationId and reason. Security review runs before the cancel commits.

gnesi.add_artifact — conversationId, name, mimeType, and bytes or uri. Returns artifactId.

gnesi.request_review — conversationId. Runs security review before a payment, a new contact privilege, or an outward send commits.

gnesi.record_hil_decision — conversationId, checkpointId, decision (approve or decline), comment.

gnesi.read_audit — conversationId, optional after hash.

gnesi.quote_access — skillId or conversationId, and to. Returns the sender-pays quote. This tool does not charge.