{"_id":"@bossforce.ai/mcp-circle","name":"@bossforce.ai/mcp-circle","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@bossforce.ai/mcp-circle","version":"0.1.0","type":"module","repository":{"type":"git","url":"git+https://github.com/bossforce-ai/bossforce-tools.git","directory":"mcps/community-membership/circle"},"publishConfig":{"access":"public"},"bin":{"bossforce-mcp-circle":"dist/bin.js"},"dependencies":{"zod":"^4.4.3","@bossforce.ai/mcp-core":"0.3.0"},"devDependencies":{"@bossforce.ai/mcp-testkit":"0.0.0"},"scripts":{"build":"tsc -p tsconfig.json","test":"node --test \"dist/*.test.js\""},"_id":"@bossforce.ai/mcp-circle@0.1.0","description":"MCP server for the **Circle Admin API v2** (`https://app.circle.so/api/admin/v2`), authenticated with an Admin API token (`Authorization: Bearer `). A good fit for surfacing community activity (members, spaces, posts) and publishing posts from an a","bugs":{"url":"https://github.com/bossforce-ai/bossforce-tools/issues"},"homepage":"https://github.com/bossforce-ai/bossforce-tools#readme","_integrity":"sha512-eITp54dyn0w5H9Oi2JawZqvzn+AXVM+ZVttedTEAwhdo3eG6MBctpb3CA02ajYtzEMLJzUapzSMlNoUKGIejAw==","_resolved":"C:\\Users\\user\\AppData\\Local\\Temp\\27840139519f6fa689fcfa93a6e5d7e1\\bossforce.ai-mcp-circle-0.1.0.tgz","_from":"file:bossforce.ai-mcp-circle-0.1.0.tgz","_nodeVersion":"22.18.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-eITp54dyn0w5H9Oi2JawZqvzn+AXVM+ZVttedTEAwhdo3eG6MBctpb3CA02ajYtzEMLJzUapzSMlNoUKGIejAw==","shasum":"9766048cfacd8bbd7b87b3df1fa2442976364f10","tarball":"https://registry.npmjs.org/@bossforce.ai/mcp-circle/-/mcp-circle-0.1.0.tgz","fileCount":26,"unpackedSize":27376,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAOlVycwR0OGjtoYvd4lJteWiBMXn5qt4rzUeBZxd1zSAiEAtN39liQ15sBaOYR0O6L5im2xMsdHffhqrBsfgMa3qKQ="}]},"_npmUser":{"name":"bossforce.ai","email":"bossforce.ai@gmail.com"},"directories":{},"maintainers":[{"name":"bossforce.ai","email":"bossforce.ai@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-circle_0.1.0_1781237899850_0.5922456863109087"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-12T04:18:19.654Z","0.1.0":"2026-06-12T04:18:19.980Z","modified":"2026-06-12T04:18:20.205Z"},"maintainers":[{"name":"bossforce.ai","email":"bossforce.ai@gmail.com"}],"description":"MCP server for the **Circle Admin API v2** (`https://app.circle.so/api/admin/v2`), authenticated with an Admin API token (`Authorization: Bearer `). A good fit for surfacing community activity (members, spaces, posts) and publishing posts from an a","homepage":"https://github.com/bossforce-ai/bossforce-tools#readme","repository":{"type":"git","url":"git+https://github.com/bossforce-ai/bossforce-tools.git","directory":"mcps/community-membership/circle"},"bugs":{"url":"https://github.com/bossforce-ai/bossforce-tools/issues"},"readme":"# @bossforce.ai/mcp-circle\n\nMCP server for the **Circle Admin API v2**\n(`https://app.circle.so/api/admin/v2`), authenticated with an Admin API token\n(`Authorization: Bearer `). A good fit for surfacing community activity\n(members, spaces, posts) and publishing posts from an agent workflow.\n\n## Credentials\n\n| Env | How to obtain |\n| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `CIRCLE_API_TOKEN` | Create an API token in your community (Settings → Developers → [Tokens](https://help.circle.so/p/sso-and-integrations/api/create-an-api-token-in-your-community)). |\n\nAdmin API access is available on Circle's **Business plan and higher**. The\ntoken is read lazily, so the server boots and answers `tools/list` without it;\ncalls fail with an `auth` error until it is set.\n\n## Tools\n\n| Tool | Arguments | Returns |\n| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------ |\n| `list_members` | `page?`, `per_page?`, `status?` | paginated `records` of members |\n| `list_spaces` | `page?`, `per_page?`, `sort?` | paginated `records` of spaces |\n| `list_posts` | `page?`, `per_page?`, `space_id?`, `space_group_id?`, `status?`, `search_text?`, `sort?` | paginated `records` of posts |\n| `create_post` | `space_id`, `name`, `body_html?`/`tiptap_body?`, `status?`, `slug?`, `user_email?`, `user_id?`, `is_comments_enabled?`, `is_liking_enabled?`, `topics?`, `skip_notifications?` | `{ message, post }` |\n\nResponses are Circle's native JSON payloads, returned as `structuredContent`.\n\n### Working with posts\n\n`create_post` targets a **basic-type space**: pass its `space_id` (from\n`list_spaces`) and a `name`, plus content via either `body_html` (an HTML string)\nor `tiptap_body` (Circle rich-text JSON) — at least one is required. Identify the\nauthor with `user_email` (preferred) or `user_id`; omit both to attribute the\npost to the API token owner. Page through `list_members`, `list_spaces`, and\n`list_posts` with `page`/`per_page` and inspect `has_next_page`.\n\n## Develop\n\n```bash\npnpm --filter @bossforce.ai/mcp-circle build\npnpm --filter @bossforce.ai/mcp-circle test\n```\n\nRegenerate the tools/list snapshot after an intentional signature change:\n\n```bash\nUPDATE_SNAPSHOTS=1 pnpm --filter @bossforce.ai/mcp-circle test\n```\n","readmeFilename":"README.md","_rev":"1-e1e8e0bb15ab81cd57e5f43b78fc4341"}