Slab API and MCP server Let your AI agent keep your Slab wiki current.

ToolWhat it doesAccess

• search_posts Search the wiki with the same filters as Slab search. read

  Returns matching posts with id, title, topics, owner and edited date. The filters are the ones Slab search offers. Results only include posts your role can open. next_cursor is empty on the last page.

  MCP callslab_read → search_posts

  REST endpointGET https://cotlet.dev/api/v1/slab/posts/search

  Parameters

  Parameters: search_posts

  Name	Type	Description
  query string required	string	Words to find; quote a phrase, put a minus before a word to exclude it
  topic string	string	Limit to one topic by name, like the in: filter
  state string	string	draft, published, public, verified, expired or archived, like the is: filter
  cursor string	string	next_cursor from the previous page

  Example input

  {
    "query": "query"
  }

  Example response

  {
    "posts": [
      {
        "post_id": "k3m9x2qa",
        "title": "Refund policy",
        "topics": [
          "Support"
        ],
        "owner": "Dana Whitfield",
        "edited": "2026-09-18",
        "state": "verified"
      },
      {
        "post_id": "p7d2w5nb",
        "title": "Refund exceptions for annual plans",
        "topics": [
          "Support",
          "Billing"
        ],
        "owner": "Leo Marsh",
        "edited": "2026-06-02",
        "state": "expired"
      }
    ],
    "next_cursor": ""
  }

• list_topics Topics you can open, with their sub-topics. read

  Returns each topic you can open with its id, name and the sub-topics under it. Private topics appear only if you are a member. Use the id or name as the topic parameter of other tools.

  MCP callslab_read → list_topics

  REST endpointGET https://cotlet.dev/api/v1/slab/topics

  Parameters

  No parameters.

  Example response

  {
    "topics": [
      {
        "topic_id": "t_support1",
        "name": "Support",
        "sub_topics": [
          "Macros",
          "Escalations"
        ]
      },
      {
        "topic_id": "t_eng0042",
        "name": "Engineering",
        "sub_topics": [
          "Runbooks"
        ]
      },
      {
        "topic_id": "t_meet007",
        "name": "Meetings",
        "sub_topics": []
      }
    ]
  }

• get_post Read one post as Markdown with its metadata. read

  Returns the title, body as Markdown, topics, owner, contributors and edited date. When the post uses verification it also returns the verifiers, the review frequency and the expiry date. Embeds and attachments come back as links.

  MCP callslab_read → get_post

  REST endpointGET https://cotlet.dev/api/v1/slab/posts/{post_id}

  Parameters

  Parameters: get_post

  Name	Type	Description
  post_id string required	string	Post id from search_posts or list_expired_posts

  Example input

  {
    "post_id": "post_8c41d2"
  }

  Example response

  {
    "post_id": "k3m9x2qa",
    "title": "Refund policy",
    "body": "# Refund policy\n\nAnnual plans are refundable within 30 days of purchase...",
    "topics": [
      "Support"
    ],
    "owner": "Dana Whitfield",
    "contributors": [
      "Leo Marsh"
    ],
    "edited": "2026-09-18",
    "verification": {
      "status": "verified",
      "verifiers": [
        "Dana Whitfield"
      ],
      "expires": "2027-03-18"
    },
    "url": "https://yourteam.slab.com/posts/refund-policy-k3m9x2qa"
  }

• create_post Create a post from Markdown, as a draft or published. writeasks first

  Creates the post in your account and returns its id, state and URL. A published post is visible to everyone who can open its topic, and Slab notifies people who follow the topic. Drafts reach no one. By default you confirm each call; you can switch that off for this tool.

  MCP callslab_write → create_post

  REST endpointPOST https://cotlet.dev/api/v1/slab/posts

  Parameters

  Parameters: create_post

  Name	Type	Description
  title string required	string	Post title
  body string required	string	Post body in Markdown
  topic string	string	Topic name to add the post to
  publish boolean	boolean	true publishes, false (default) saves a draft

  Example input

  {
    "title": "Weekly sync notes",
    "body": "## Decisions\n- Ship the billing fix Thursday\n\n## Actions\n- Ana: update the runbook",
    "topic": "Meetings",
    "publish": false
  }

  Example response

  {
    "post_id": "m5q1y8tc",
    "title": "Weekly sync notes",
    "state": "draft",
    "topics": [
      "Meetings"
    ],
    "url": "https://yourteam.slab.com/posts/weekly-sync-notes-m5q1y8tc"
  }

• add_post_topic Add a post to a topic. write

  Adds the topic to the post and returns the post's topics. It reaches no one and one more call removes the topic again, so it asks for no confirmation. You need edit access to the post.

  MCP callslab_write → add_post_topic

  REST endpointPOST https://cotlet.dev/api/v1/slab/posts/{post_id}/topic

  Parameters

  Parameters: add_post_topic

  Name	Type	Description
  post_id string required	string	Post id
  topic string required	string	Topic name

  Example input

  {
    "post_id": "post_8c41d2",
    "topic": "topic"
  }

  Example response

  {
    "post_id": "m5q1y8tc",
    "topics": [
      "Meetings",
      "Engineering"
    ]
  }

ToolWhat it doesAccess

• list_expired_posts Posts whose verification has expired, optionally in one topic. read

  Returns posts in the expired state, the one Slab turns yellow in the post banner, with owner, verifiers and the date verification expired. Oldest expiry first. next_cursor is empty on the last page.

  MCP callslab_read → list_expired_posts

  REST endpointGET https://cotlet.dev/api/v1/slab/expired-posts

  Parameters

  Parameters: list_expired_posts

  Name	Type	Description
  topic string	string	Limit to one topic by name
  cursor string	string	next_cursor from the previous page

  Example response

  {
    "posts": [
      {
        "post_id": "p7d2w5nb",
        "title": "Refund exceptions for annual plans",
        "owner": "Leo Marsh",
        "expired": "2026-08-02"
      },
      {
        "post_id": "r2c8v1ze",
        "title": "On-call handover checklist",
        "owner": "Ana Ruiz",
        "expired": "2026-09-11"
      }
    ],
    "next_cursor": ""
  }

• verify_post Mark a published post as verified, with a review frequency. writeasks first

  Sets the post to verified, shows the green banner with who verified it and the expiry date, and returns both. Only published posts can be verified, and only people with edit access to the post. Verifiers are reminded when the date nears. By default you confirm each call; you can switch that off for this tool.

  MCP callslab_write → verify_post

  REST endpointPOST https://cotlet.dev/api/v1/slab/posts/{post_id}/verify

  Parameters

  Parameters: verify_post

  Name	Type	Description
  post_id string required	string	Post id of a published post
  frequency string	string	How often the post must be reverified, in Slab's own options for the post

  Example input

  {
    "post_id": "post_8c41d2"
  }

  Example response

  {
    "post_id": "p7d2w5nb",
    "status": "verified",
    "verified_by": "Maya Cole",
    "expires": "2027-04-28"
  }

• request_verification Ask the verifiers of a post to verify it. writeasks first

  Sends the request through Slab and returns who was asked. The person gets a Slab notification. Only people with edit access to the post can request verification. By default you confirm each call; you can switch that off for this tool.

  MCP callslab_write → request_verification

  REST endpointPOST https://cotlet.dev/api/v1/slab/posts/{post_id}/verification/request

  Parameters

  Parameters: request_verification

  Name	Type	Description
  post_id string required	string	Post id of a published post
  verifier string	string	Person to ask; the post owner by default

  Example input

  {
    "post_id": "post_8c41d2"
  }

  Example response

  {
    "post_id": "r2c8v1ze",
    "requested_from": "Ana Ruiz",
    "status": "requested"
  }

ToolWhat it doesAccess

• get_post_insights Views and readers of one post over a period. read

  Returns the same figures as Post Insights in the post menu: the view count for the period and the people who read it. Whether Slab shows insights to your role is Slab's rule; without access the call fails with a permission error.

  MCP callslab_read → get_post_insights

  REST endpointGET https://cotlet.dev/api/v1/slab/posts/{post_id}/insights

  Parameters

  Parameters: get_post_insights

  Name	Type	Description
  post_id string required	string	Post id
  period_days integer	integer	How far back to count, in days

  Example input

  {
    "post_id": "post_8c41d2"
  }

  Example response

  {
    "post_id": "p7d2w5nb",
    "period_days": 90,
    "views": 41,
    "readers": [
      "Maya Cole",
      "Tom Reyes"
    ]
  }

• archive_post Archive a post so it leaves topics and default search. writeasks first

  Archives the post and returns its new state. Slab keeps archived posts, and the archived filter in search finds them again. People who linked to the post lose it from topics. By default you confirm each call; you can switch that off for this tool.

  MCP callslab_write → archive_post

  REST endpointPOST https://cotlet.dev/api/v1/slab/posts/{post_id}/archive

  Parameters

  Parameters: archive_post

  Name	Type	Description
  post_id string required	string	Post id

  Example input

  {
    "post_id": "post_8c41d2"
  }

  Example response

  {
    "post_id": "r2c8v1ze",
    "title": "On-call handover checklist",
    "state": "archived"
  }