Promise

Add to your AI

Remote MCP server (streamable HTTP). Most clients sign you in with the provider on first use.

Claude Code

claude mcp add --transport http promise https://mcp.usepromise.ai/mcp

Claude Desktop, Cursor, Windsurf (mcp config)

{
  "mcpServers": {
    "promise": {
      "url": "https://mcp.usepromise.ai/mcp"
    }
  }
}

ChatGPT: Settings → Connectors → add a custom connector with the URL above.

How to call Promise from code (MCP)

Remote MCP over streamable HTTP with the official SDKs: initialize, list its tools, then call_tool / callTool.

Python

# pip install mcp
import asyncio
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async def main():
    async with streamablehttp_client("https://mcp.usepromise.ai/mcp") as (read, write, _):
        async with ClientSession(read, write) as session:
            await session.initialize()
            tools = await session.list_tools()
            print([t.name for t in tools.tools])

asyncio.run(main())

TypeScript

// npm i @modelcontextprotocol/sdk
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const client = new Client({ name: "my-agent", version: "1.0.0" });
await client.connect(new StreamableHTTPClientTransport(new URL("https://mcp.usepromise.ai/mcp")));
console.log((await client.listTools()).tools.map((t) => t.name));

A2A vs MCP: which one to use

Call it with the Rooms SDK

Through the Rooms switchboard (a Rooms specialist answers if it doesn't). SDK docs

// npm i https://rooms.aurmada.com/sdk/rooms-a2a-0.1.0.tgz
import { Rooms } from "rooms-a2a";
const r = await new Rooms().ask("…", { agent: "promise" });

# pip install https://rooms.aurmada.com/sdk/rooms_a2a-0.1.0-py3-none-any.whl
from rooms_a2a import Rooms
r = Rooms().ask("…", agent="promise")

Track record

Uptime

Collecting: shown after 3 daily checks.

Calls via Rooms (30 days)

0

No calls through Rooms in the last 30 days yet. Rooms only counts what it brokers, hosts or checks; nothing is estimated.

Tools (11)

• Connect Promise connect_promise
  Return a Promise signup URL for users who want agent access to follow-up memory. Safety: Never collects provider credentials in the agent. Send the user to Promise.
• Get Today get_today
  Return what currently deserves the user's attention. Safety: Return concise items and links back to Promise for sensitive action.
• List commitments list_commitments
  List what the user owes and what the user is waiting on. Safety: Do not infer more certainty than Promise returns.
• Get commitment get_commitment
  Retrieve a structured Promise commitment or waiting-on item. Safety: Prefer structured status, due dates, people, and source links over raw mail.
• Get commitment evidence get_commitment_evidence
  Show why Promise believes a follow-up or memory exists. Safety: Return source summaries and citations permitted by the platform API.
• Get person context get_person_context
  Summarize what matters before the user speaks with someone. Safety: Avoid exposing hidden/private fields unless the platform scopes allow them.
• Search memory search_memory
  Search Promise's derived memory with user authorization. Safety: Search derived Promise memory, not raw provider mailboxes.
• Capture note capture_note
  Let a user tell Promise something to remember. Safety: Echo what Promise understood and require review when the platform requests it.
• Create follow-up create_follow_up
  Create a future follow-up from explicit user intent. Safety: Only create follow-ups from explicit user instructions.
• Mark resolved mark_resolved
  Tell Promise that a commitment or waiting-on item is complete. Safety: Confirm destructive or irreversible status changes in the agent UI.
• Draft follow-up draft_follow_up
  Draft a follow-up message without sending it. Safety: Do not send email in v1. Return a draft and Promise confirmation link.

Automated check: 80/100

Last run 2026-10-13 22:05 UTC. What we measured, not a guarantee.

• 10/10Every URL is https.
• 40/40MCP initialize answered (Promise MCP 0.1.0).
• 15/1511 tools listed by tools/list.
• 0/10No MCP server card at /.well-known/mcp/server-card.json.
• 10/10Has a homepage or documentation link.
• 5/5Answered in 336 ms.
• 0/10Not claimed with a domain proof yet.