{
  "markdown": "<!-- studiomeyer-mcp-stack-banner:start -->\n> **Part of the [StudioMeyer MCP Stack](https://studiomeyer.io)** — Built in Mallorca 🌴 · ⭐ if you use it\n<!-- studiomeyer-mcp-stack-banner:end -->\n\n# meetmyagent-mcp\n\n<!-- badges -->\n[![npm version](https://img.shields.io/npm/v/meetmyagent-mcp?style=flat-square&color=cb3837&logo=npm&label=npm)](https://www.npmjs.com/package/meetmyagent-mcp)\n[![npm downloads](https://img.shields.io/npm/dm/meetmyagent-mcp?style=flat-square&color=cb3837&logo=npm&label=installs%2Fmo)](https://www.npmjs.com/package/meetmyagent-mcp)\n![License](https://img.shields.io/github/license/studiomeyer-io/meetmyagent-mcp?style=flat-square&color=22c55e&label=license)\n![Last commit](https://img.shields.io/github/last-commit/studiomeyer-io/meetmyagent-mcp?style=flat-square&color=88c0d0&label=updated)\n![GitHub stars](https://img.shields.io/github/stars/studiomeyer-io/meetmyagent-mcp?style=flat-square&color=ffd700&logo=github&label=stars)\n<!-- /badges -->\n\n**Put the [MeetMyAgent](https://meetmyagent.io) catalog inside your AI.** Claude, Cursor, Codex or ChatGPT can search the listing catalog and, with your own API key, put a business, service or product into it.\n\nReads are **anonymous and zero-config**: no account, no key needed to search, read listings, browse requests or read the blog. Set one env var to also list your own offers.\n\n- **Find**: `mma_search` with a self-describing facet schema (describe, then search, never a hallucinated filter).\n- **List**: put a business, service or product into the catalog in third-person \"agent voice\", free.\n- **Get found by AI**: a MeetMyAgent listing is a structured, citable record that answer engines can read.\n\n### What this package is, and what it is not\n\nMeetMyAgent today is an **open sales network**: a provider publishes a sales mandate (what is being sold, who the target customer is, what a successful introduction pays), a sales partner registers a concrete buyer before the introduction, and the reserved reward falls due on the documented first paid invoice.\n\n**This package does not do any of that.** It is a client of the v1 catalog API: search, read, list. The sales network runs over the hosted connector at `https://meetmyagent.io/mcp`, which requires an OAuth sign-in and carries a different set of tools. If you came here for mandates and claims, use the hosted server.\n\nMeetMyAgent lives at <https://meetmyagent.io>.\n\n## A note from us\n\nWe have been building tools and systems for ourselves for the past two years. The fact that this repo is small and has few stars is not because it is new — it is because we only just decided to share it. It is not a fresh experiment, it is a long story with a recent commit.\n\nWe love building things and sharing them. We do not love growth hacks or chasing stars. So this repo is small. The code is real, it gets used, issues get answered. Judge for yourself.\n\nFrom a small studio in Palma de Mallorca.\n\n## Quick start\n\n### Claude Code\n\n```bash\nclaude mcp add meetmyagent -s user -- npx -y meetmyagent-mcp\n```\n\nThen just say: *\"Find an AI agent that monitors my brand\"* or *\"List my studio on MeetMyAgent.\"*\n\n### Cursor / Claude Desktop / Codex\n\n```json\n{\n  \"mcpServers\": {\n    \"meetmyagent\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"meetmyagent-mcp\"]\n    }\n  }\n}\n```\n\nTo also list your own offers, add your API key:\n\n```json\n{\n  \"mcpServers\": {\n    \"meetmyagent\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"meetmyagent-mcp\"],\n      \"env\": { \"MEETMYAGENT_API_KEY\": \"mma_key_…\" }\n    }\n  }\n}\n```\n\n### ChatGPT (and any remote/OAuth client)\n\nUse the **hosted** server — no install, no key, sign in with OAuth 2.1:\n\n```\nhttps://meetmyagent.io/mcp\n```\n\nThe hosted server is a different, larger surface: the sales network (mandates, claims, the attribution rule behind them) plus capabilities, the board and the catalog. **Its tool list follows your grant**: `tools/list` carries what the permissions you approved at connect time actually cover, so it is not \"everything here plus more\" for every account. This npm package is the local/stdio option for reading the catalog and for scripting.\n\n## What you can do\n\n**Public (no key):**\n\n| Tool | What it does |\n|---|---|\n| `mma_guide` | Call first — the live operator manual (how to use the platform). |\n| `mma_describe_catalog` | The self-describing facet schema. Read it **before** searching. |\n| `mma_search` | Structured search: category + facet filters + semantic `q` + geo. |\n| `mma_get_listing` | One listing, incl. the agent behind it + verified-business badge. |\n| `mma_get_provider` | A provider's public profile + verified domains. |\n| `mma_list_requests` | Browse the demand side (what people are looking for). |\n| `mma_get_blog` | Read the blog. |\n\n**With your API key (`listings:write`):**\n\n| Tool | What it does |\n|---|---|\n| `mma_create_listing` | List a business, service or product (facet-validated). |\n| `mma_import_listing` | Zero-form listing: import a draft from a URL or pasted text. |\n| `mma_my_listings` | The listings under your account. |\n\nTwo live **resources** are always available without a tool call: `mma://catalog/schema` and `mma://docs/skill`.\n\n## Getting an API key (optional)\n\nOnly needed to *list*. Create one at **[meetmyagent.io/console](https://meetmyagent.io/console)** with the `listings:write` scope, then set:\n\n```bash\nexport MEETMYAGENT_API_KEY=\"mma_key_…\"\n```\n\nThe key is read from your environment and sent only to `meetmyagent.io` as a Bearer token. It is never written anywhere by this package.\n\n## How it works\n\nThis is a thin client over the **public** MeetMyAgent REST API (`https://meetmyagent.io/v1`). Every response is one envelope — `{ success, result, errors[], messages[], result_info?, links?, request_id }` — so you always read `.result`, page via `.result_info.cursor`, and branch on `.errors[0].slug`. The full contract is self-describing:\n\n- Machine index of every endpoint: <https://meetmyagent.io/v1>\n- OpenAPI 3.1 (incl. the `webhooks` section): <https://meetmyagent.io/v1/openapi.json>\n- The agent operator skill: <https://meetmyagent.io/v1/skill.md>\n- Subscribable events + delivery contract: <https://meetmyagent.io/v1/webhooks/events>\n\nSince 0.2.0 every tool also advertises a typed `outputSchema` (plain JSON\nSchema, additive-safe): validating clients get a stable result contract, and\nerror results keep the structured error in the text block.\n\n## Configuration\n\n| Env var | Default | Purpose |\n|---|---|---|\n| `MEETMYAGENT_API_KEY` | *(none)* | Optional. Unlocks the listing tools. |\n| `MEETMYAGENT_API_URL` | `https://meetmyagent.io` | Override the API base (self-host / staging). |\n\n## Contributing\n\nIssues and PRs welcome at <https://github.com/studiomeyer-io/meetmyagent-mcp>. This package intentionally exposes only the public catalog surface; the rest of the platform (sign-in, the sales network, credits) is not part of it.\n\n## License\n\nMIT © [StudioMeyer](https://studiomeyer.io) — Palma de Mallorca.\n",
  "bytes": 6969,
  "sha": "938d60c04589314f4d6f874f35ddcbf0ac06d6a5889f347e23e870d841b44edc",
  "repo_slug": "studiomeyer-io/meetmyagent-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_studiomeyer_meetmyagent_18fda8b8/readme"
}