# Metaphor — MCP server on mcp.ai
> Connect your Metaphor account and use 1 tools for artificial intelligence straight from your AI agent. Connect with your own API key. Metaphor is a neural search engine that enables developers to perform contextually relevant searches by understanding how people describe and share content online.

By: mcp.ai · official
Page: https://mcp.ai/metaphor

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_metaphor?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/metaphor/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/metaphor/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/metaphor/skill.md
Postman collection (v2.1): https://mcp.ai/metaphor/postman.json

## Tools
- metaphor_get_contents(endChar?: integer, contents: string[], startChar?: integer) — Tool to retrieve parsed HTML/text contents and metadata for documents by their IDs." Use when you need to fetch the full text and metadata of multiple documents at once.

## Example prompts
- "What can I do in Metaphor?"
- "Show me a summary of my Metaphor account"

## Links
Docs: https://mcp.ai/docs/mcps/metaphor
Website: https://mcp.ai/mcps/metaphor