Docs — Automation

Manage comments from your editor

One token, zero browser tab hopping. Let your AI assistant create sites, invite teammates, verify domains and paste the embed code for you.

01

Get a token (once)

Open Profile → MCP Token Management, generate an amcp_ token and copy it. Keep it like a password.

02

Add the MCP server

Paste the JSON below into Claude Desktop, Cursor or VS Code. Replace the token and restart the client.

03

Talk to your assistant

Ask: "Create an org for my blog, invite bob@ex.com, verify mui.dev and give me the embed code."

Client config

Single endpoint, stateless POST. No SSE, no extra routes.

claude.json / cursor mcp
{
  "mcpServers": {
    "awesome-comment": {
      "url": "https://awesomecomment.org/api/mcp",
      "headers": {
        "Authorization": "Bearer amcp_your_token_here"
      }
    }
  }
}

Endpoint: https://awesomecomment.org/api/mcp — Requires Authorization: Bearer amcp_***. Add it once, reuse everywhere.

16 tools, one workflow

From org to embed code, everything your assistant needs. Sorted by the order you will use them.

list_orgsList your orgs with role and member count.
create_orgCreate a new org (you become owner, limit 10).
get_orgGet one org's details.
list_membersList members of an org.
invite_memberInvite by email (admin/moderator/viewer, 7-day link).
update_member_roleChange a member's role.
remove_memberRemove a member (keeps last owner).
get_subscriptionCheck plan, site limit and AI quota.
leave_orgLeave an org yourself.
transfer_ownershipTransfer ownership to another member.
list_sitesList sites you can access.
create_siteCreate a site, optionally with domain verification ticket.
list_domainsList all verified domains across your orgs.
add_domainRegister a domain and get the verification token.
verify_domainVerify the token at /.well-known/awesome-comment-verification.
generate_integration_codeGet the paste-ready <script> snippet for a site.

Example chat

Copy-paste this prompt to your AI assistant after the server is connected.

assistant prompt
You: Create org "Mui Blog" and a site "mui.dev" for mui.dev
Assistant: Created org org_xxx (Mui Blog). Created site site_yyy for mui.dev — verification token: abc123...
You: I added the token file. Verify it.
Assistant: Domain mui.dev verified.
You: Give me the embed code.
Assistant: <script>...siteId: "site_yyy"...</script> — paste before </body>.

Tips

  • • Token is shown only once — save it to 1Password. Revoke in Profile if leaked.
  • • Verification token expires in 30 minutes. If expired, call add_domain again.
  • • Each org caps at 10 created orgs per user. Free plan allows 1 site, Pro 10, Pro+ 50.

FAQ

Why no SSE?

SSE needs a long-lived connection. Our Workers are stateless — single POST keeps it simple, fast and compatible with all MCP clients.

Do I need to open the website again?

Only once for the token. Afterwards orgs, members, domains and embed code all work via MCP.

How to revoke a token?

Profile → MCP Token Management → Revoke. The client will get 401 until you add a new token.

Generate a tokenNext.js guide