Hosted MCP server/Development

Heard MCP server

Hosted at api.heard.dev·Streamable HTTP

Heard is a voice layer for coding agents. Cloud agents such as Claude, ChatGPT, Devin, and Copilot coding agent send progress updates that the Heard macOS app reads aloud. The Heard app for macOS must be installed and signed in; spoken reports require an active trial or subscription, and two-way voice requires Heard Power. Grok Bot, ChatGPT, and Claude use Heard email-code OAuth; Meta Muse, Devin, Copilot, and Manus use a token created in Heard Settings. Tokens are shown once and should never be pasted into chat.

api.heard.dev Streamable HTTP OAuth (Heard email code) or token created in Heard Settings Server not checked yet Reviewed 2026-11-16
About

Where it fits

Developers using cloud coding agents with the Heard macOS app for spoken progress updates.

  • Install and sign in to the Heard macOS app.
  • Connect Claude or ChatGPT through Heard email-code OAuth.
  • Create a token in Heard Settings for Devin or Copilot.

A remote MCP server advertises tools to your client. The provider controls the tools, the data they can reach, and the permissions they need. Read the provider's docs before you use it with private data.

Setup

Install it in your client

Choose a client, run the command or use the one-click install, then verify the connection. The endpoint uses Streamable HTTP.

All client guides
  1. 01

    Run this command in your terminal

    This adds Heard as a remote Streamable HTTP server in Claude Code.

    Claude Code
    claude mcp add --transport http heard https://api.heard.dev/v1/mcp/agent --scope project
  2. 02

    Verify the connection

    Run claude mcp list, or open /mcp in a Claude Code session.

    Learn more about MCP in Claude Code

More clients, including project and global config files, are in the sidebar.

Connection

Endpoint and configuration

Endpoint
https://api.heard.dev/v1/mcp/agent
Host
api.heard.dev · /v1/mcp/agent
Transport
Streamable HTTP
Authentication
OAuth (Heard email code) or token created in Heard Settings
Server name
heard
Listing type
Community or directory listing

The installer uses the server name heard. If you add the endpoint by hand, keep the same name so the guide and your config match.

Verification

Check the connection

After you add the server, confirm that the client can see its tools and that one small request returns what the provider describes.

  1. 1
    Open the tool list.

    Restart the client or start a new session. Confirm that heard appears and that the tools match the provider documentation.

  2. 2
    Run one small request.

    Start with: Install and sign in to the Heard macOS app. Check the result before you give the server more access.

  3. 3
    Check permissions.

    Review the OAuth scopes or API-key permissions, then remove the server and revoke its token when you no longer need it.

Server not checked yet

We checked the provider's page, not the MCP connection itself. No MCP sign-in or tool call was attempted. A provider page is linked but was not included in the automated check. Open it before setup.

Troubleshooting

Common failure modes

These are the problems to check first. If the provider changes its endpoint or authentication flow, use its documentation as the source of truth.

  • The sign-in window closes without returning. Allow pop-ups and finish the provider login in the same browser.
  • The server connects but its tools are missing. Remove it, add it again, and approve the scopes the provider lists.
  • Your client does not support Streamable HTTP. Use a client that does, and confirm the provider's current endpoint and transport in its docs.
Safety

Before you connect

Remote means provider access
  • The provider can see the requests and data your agent sends through the server.
  • Review OAuth scopes and API-key permissions. Start read-only if the provider offers it.
  • Use project scope for repository-specific servers; use global scope for personal tools.
  • Remove the server and revoke its token when you stop using it.
Review path

Check the connection before a real task

These guides cover the decisions that a provider description cannot answer: endpoint ownership, scopes, tool access, and a read-only test.

Reference

Provider documentation

Setup requirements, available tools, and rate limits live with the provider. Use the source link as the authority for this server.

Heard documentationhttps://docs.heard.dev/cloud-agentsGitHub repositoryhttps://github.com/heardlabs/heard-mcp