{
  "markdown": "# youspot\n\nThe official CLI and SDK for [YouSpot](https://youspot.com), the AI-native personal CRM.\n\nNode 18 or newer. No dependencies.\n\n```bash\nnpx youspot ask \"what does it cost\"\nnpx youspot docs oauth pkce\nnpx youspot read /docs/mcp\nnpx youspot tools\n```\n\nOnly `youspot call` needs a credential. Everything else reads pages that are already public.\n\n## Commands\n\n| Command                      | What it does                                                                                 | Credential      |\n| ---------------------------- | -------------------------------------------------------------------------------------------- | --------------- |\n| `youspot ask <question>`     | Asks about YouSpot. Answers are passages from its own pages, each with the URL it came from. | none            |\n| `youspot docs <query>`       | Searches the developer docs over the documentation MCP server.                               | none            |\n| `youspot read <path>`        | One page as markdown, for example `/docs/mcp` or `/pricing`.                                 | none            |\n| `youspot pages`              | Every page that can be read.                                                                 | none            |\n| `youspot tools`              | Lists the MCP tools on the product server.                                                   | none            |\n| `youspot call <tool> [json]` | Calls one MCP tool.                                                                          | `YOUSPOT_TOKEN` |\n| `youspot member <username>`  | One public member profile.                                                                   | none            |\n| `youspot directory`          | A page of the public member directory.                                                       | none            |\n| `youspot index`              | Every endpoint, and what each one costs in credentials.                                      | none            |\n\n`--json` prints the raw response. `--limit n` applies to `ask`, `docs` and `directory`.\n\n## Credentials\n\nEvery YouSpot tool reads or writes one person's own contacts, companies, notes and files, so\nthere is no service credential and no API key: a token always belongs to a person. Mint one at\n[youspot.com/user/mcp](https://youspot.com/user/mcp) and set `YOUSPOT_TOKEN`, or follow the\nOAuth 2.1 flow in [auth.md](https://youspot.com/auth.md).\n\n## As a library\n\n```js\nimport { ask, tools, callTool } from \"youspot\";\n\nconst answer = await ask(\"how do I connect a client\");\nconst available = await tools();\nconst summary = await callTool(\"get_connections_summary\", {}, { token });\n```\n\n`YOUSPOT_BASE_URL` overrides the origin, for anyone running YouSpot elsewhere.\n\n## What is in this package\n\n- `bin/youspot.mjs`, `src/index.mjs`: the CLI and the SDK.\n- `plugin.json`: an [Agent Plugins](https://agent-plugins.org) manifest bundling both MCP\n  servers and the three skills.\n- `AGENTS.md`, `.cursorrules`: instructions for coding agents.\n- `skills/`: the three agent skills, byte-identical to the ones served at\n  `youspot.com/.well-known/agent-skills/`.\n\n`AGENTS.md`, `.cursorrules` and `skills/` are generated, not hand-written. The site publishes a\nsha256 of each skill's served bytes, so a hand-copied file here would eventually disagree with\nthe digest on the site and with every client that verifies it. Regenerate with\n`bun run sync:agent-tools` from the repo root. CI runs `check:agent-tools` and fails if they\nhave drifted. It runs there rather than in the frontend build because `.vercelignore` excludes\n`*.md`, so on Vercel these four files are not in the build context at all.\n\n## Publishing\n\nThe source of truth is `packages/youspot-agent-tools` in a private monorepo. This repo is its\npublic mirror, and npm is published from here, so that `repository` and `homepage` both resolve:\nthose two links are how an agent tells the official package from a lookalike.\n\n```bash\nnpm login\nnpm publish\n```\n\nNothing publishes automatically. To refresh the mirror after a change upstream, run\n`bun run sync:agent-tools` in the monorepo, then copy this directory over and commit.\n",
  "bytes": 4150,
  "sha": "4ffa0cfa4ea7c38154e3ff87849fe5808519bfa848cd2e5a27560612f1f52798",
  "repo_slug": "onstartups/youspot-agent-tools",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_youspot_youspot_1c1220a9/readme"
}