MCP Server

The Tightknit MCP server is currently in pilot. Contact Support if you’d like to join the pilot and turn it on for your community.

The Tightknit MCP server lets AI agents work inside your community on your behalf. It implements the Model Context Protocol, an open standard that connects AI apps to external tools, so an agent like Claude, ChatGPT, or Cursor can read your feeds, post and moderate discussions, run polls, manage members, and more, all through natural language. This is a remote, hosted server: there is nothing to install and no API key to manage. You add one URL to your agent and sign in with your Tightknit account.

Let your agent set it up for you

The fastest way to get started is to hand this page to your agent and let it walk you through the setup. Paste the following prompt into Claude, ChatGPT, Cursor, or the agent of your choice:

Copy this into your agent

I want you to help manage my Tightknit community. Read the contents of this
page https://docs.tightknit.ai/integrations/mcp and recommend the best way to
get started, then help me connect the Tightknit MCP server. Once it's
connected, list the communities I can access so we can confirm it works.

Your agent will read this guide, add the server to its configuration, and prompt you to sign in. If you’d rather set it up by hand, follow the steps below.

Connection details

Access requires the MCP User role (admins have full access), in a community that’s in the pilot. If you can’t sign in, ask Support to enable the MCP server for your community.

Setting	Value
Server URL	`https://mcp.tightknit.ai/mcp`
Transport	Streamable HTTP
Authentication	OAuth 2.1. Sign in with your Tightknit account when prompted.
Access	Admins, and roles granted MCP User, in the pilot

You never paste a token or secret. On first connect, your agent opens a browser window where you sign in, and the communities you can access are scoped to that account automatically.

Connect your agent

Add the server from the terminal:

claude mcp add --transport http tightknit https://mcp.tightknit.ai/mcp

Then run /mcp inside Claude Code and choose Authenticate to sign in through your browser. Once connected, /mcp lists the Tightknit tools as available.

Add Tightknit as a custom connector:

Open Connectors settings

Go to Settings > Connectors in Claude Desktop or on claude.ai.

Add a custom connector

Click Add custom connector, name it Tightknit, and paste https://mcp.tightknit.ai/mcp as the URL.

Connect and sign in

Save the connector, click Connect, and sign in with your Tightknit account. Tightknit’s tools then appear in the tools menu.

Custom connectors are available on Claude plans that support them. If you don’t see Add custom connector, check your plan or workspace settings.

Add the server to .cursor/mcp.json in your project (or ~/.cursor/mcp.json for every project):

.cursor/mcp.json

{
  "mcpServers": {
    "tightknit": {
      "url": "https://mcp.tightknit.ai/mcp"
    }
  }
}

Open Cursor Settings > MCP, then click the Tightknit server and authenticate when prompted.

Add the server to .vscode/mcp.json in your workspace:

.vscode/mcp.json

{
  "servers": {
    "tightknit": {
      "type": "http",
      "url": "https://mcp.tightknit.ai/mcp"
    }
  }
}

Start the server from the mcp.json editor and sign in when the browser opens. The tools become available to Copilot in agent mode.

ChatGPT supports custom MCP servers, but the tools available depend on your plan. Business, Enterprise, and Edu plans support read and write tools; Pro is limited to read-only tools, and support on other plans varies. The Tightknit server includes write and destructive tools, so use a plan that supports full connectors to get the complete tool set.ChatGPT and Codex desktop apps

Open the MCP settings

Go to Settings > Plugins and select MCPs.

Add the server

Click + Add server, enter Tightknit as the name, choose Streamable HTTP as the type, paste https://mcp.tightknit.ai/mcp as the URL, then click Save.

Click Authenticate next to Tightknit in the server list and complete the sign-in with your Tightknit account.

ChatGPT on the web

Open browser plugins

Go to Settings > Plugins > Browser plugins and click + to add a new plugin.

Name the plugin

Enter a name and description, for example Tightknit.

Point it at the server

Set Connection type to Server URL and enter https://mcp.tightknit.ai/mcp. This is the server itself, not the address of this documentation page.

Choose authentication

Set Authentication to OAuth and leave every field under Advanced OAuth settings empty. ChatGPT discovers the Auth URL, Token URL, and registration endpoint from the server. There is no client ID or client secret to enter.

Create and sign in

Tick the custom-server acknowledgement, click Create, then complete the Tightknit sign-in when prompted.

ChatGPT’s connector support and plan requirements change often. See OpenAI’s developer mode documentation for current details.

Point any client that supports remote MCP servers over Streamable HTTP with OAuth at the server URL. Most clients use this shape:

{
  "mcpServers": {
    "tightknit": {
      "type": "http",
      "url": "https://mcp.tightknit.ai/mcp"
    }
  }
}

The client handles the OAuth sign-in on first use. No API key is required.

How access works

The MCP server never holds your password and issues no long-lived key. Your agent completes a standard OAuth 2.1 sign-in, and every request is authorized against your role and permissions in the Studio. A few things follow from this:

Role-based — Admins have full access. Everyone else needs the MCP User role, which grants the mcp:access permission to connect. Without it, you can’t reach the server.
Tools follow your Studio permissions — Beyond connecting, each tool checks your Studio role and permissions, so an agent only sees the tools your roles allow. For example, pairing MCP User with Events Manager exposes the events tools but not the polls, members, or site tools. Admins can use every tool.
Scoped to your communities — The agent only acts on communities where your role has access. If you can reach more than one, ask the agent to run list_tenants first, then reference the community you want by the tenant_id it returns.

Available tools

Each tool is annotated so your agent understands the impact of an action before it runs one:

Read — Fetches data. Never changes anything.
Write — Creates or updates content in your community.
Destructive — Deletes content. Cannot be undone.

Tools for features your plan doesn’t include won’t appear in your agent’s tool list, and a few fields on the tools you do see (such as group flair, award certificates, and uploading a custom font file) are only accepted with the matching feature. Every destructive tool also takes a confirm parameter the agent must set to true. It makes a delete an explicit act rather than an incidental one, but the agent supplies it, so it is not a substitute for your own approval: keep a human in the loop for deletes. Destructive here means the row is gone, not hidden: there is no trash and nothing to restore from. Where a reversible option exists, the tool’s description points at it — an event can go back to draft instead of being deleted, a journey can be disabled, a feed can be archived, and a post or comment can be unpublished.

Agents can create, edit, publish, and delete real content in your community. Review what your agent proposes before you approve write actions, and keep a human in the loop for moderation and member changes.

Communities

Tool	What it does	Access
`list_tenants`	List the communities you can access	Read

Events

Tool	What it does	Access
`list_events`	List the community’s calendar events, optionally filtered by tag	Read
`get_event`	Get one event with hosts, speakers, tags, registrant count, recap, and reminders	Read
`create_event`	Create a calendar event, with hosts, speakers, tags, registration and webhook settings, and reminders	Write
`edit_event`	Update an event’s details, hosts, speakers, tags, registration and webhook settings, post-event recap, and reminders	Write
`delete_event`	Permanently delete an event and its registrations, and its Slack announcements if it is still published	Destructive

Activity

Tool	What it does	Access
`list_activities`	Read the activity log (posts, comments, reactions, joins, votes, and more)	Read

Slack

Tool	What it does	Access
`list_slack_channels`	List the Slack channels Tightknit can post to	Read

Polls

Tool	What it does	Access
`list_polls`	List polls, newest first	Read
`get_poll`	Get a poll’s question, options, and results	Read
`create_poll`	Create a poll and post or schedule it to Slack	Write
`update_poll`	Edit, reschedule, open, or close a poll	Write
`delete_poll`	Permanently delete a poll, every response to it, and its Slack message	Destructive

Members

Tool	What it does	Access
`list_members`	List members, with optional search by name or email	Read
`create_member`	Add a member from an email address	Write
`deactivate_member`	Deactivate a standalone member	Write

Posts and comments

Tool	What it does	Access
`list_posts`	List posts across feeds	Read
`get_post`	Get one post with its body and engagement counts	Read
`get_post_comments`	List the comments on a post	Read
`edit_post_content`	Edit a post’s title, slug, and SEO description	Write
`set_post_published`	Publish or unpublish a post	Write
`set_comment_published`	Publish or unpublish a comment	Write

Search

Tool	What it does	Access
`search_posts`	Full-text search across posts	Read
`search_comments`	Full-text search across comments	Read

Feeds

Tool	What it does	Access
`list_feeds`	List feeds, including archived and unlisted ones	Read
`get_feed`	Get one feed’s full settings	Read
`update_feed`	Update a feed’s label, slug, visibility, and placement	Write

Groups

Tool	What it does	Access
`list_groups`	List member groups with their member counts	Read
`get_group`	Get a group and a page of its members	Read
`create_group`	Create a member group	Write
`edit_group`	Update a group’s settings	Write
`add_group_members`	Add members to a group	Write
`remove_group_members`	Remove members from a group, dropping any award and abilities the group gave them	Destructive
`delete_group`	Permanently delete a group, its memberships, and any award given for belonging to it	Destructive

Site

Tool	What it does	Access
`get_site`	Get the community’s site settings, including its canonical site URL	Read
`edit_site`	Update the community’s site settings	Write

Onboarding

Tool	What it does	Access
`get_community_onboarding_settings`	Get the welcome message new members are sent and the Community Guidelines shown on your site	Read
`edit_community_onboarding_settings`	Update the welcome message and the Community Guidelines	Write

Journeys

Tool	What it does	Access
`list_journeys`	List journeys, including the milestones and completion award for each	Read
`get_journey`	Get a journey, its ordered milestones, and its completion award	Read
`create_journey`	Create a journey, optionally with the award members earn on completing it	Write
`add_milestone`	Add a milestone to a journey	Write
`edit_journey`	Update a journey’s settings, including its completion award and the order of its milestones	Write
`edit_milestone`	Replace a milestone’s definition	Write
`delete_milestone`	Permanently delete one milestone and the achievements for it	Destructive
`delete_journey`	Permanently delete a journey, its milestones, and member progress	Destructive

Awards

Tool	What it does	Access
`list_awards`	List the community’s awards	Read
`list_award_assignments`	List awards assigned to members, one result per instance an award was given	Read
`create_award`	Create a reusable award (badge, profile frame, or certificate)	Write
`edit_award`	Update an award	Write
`give_award`	Give an award to one or more community members	Write
`delete_award`	Permanently delete an award, including every record of members having received it	Destructive

Content library

Tool	What it does	Access
`list_content_collections`	List content-library collections	Read
`create_content_collection`	Create a content collection	Write
`edit_content_collection`	Update a content collection	Write
`delete_content_collection`	Permanently delete a collection, leaving its resources without one	Destructive
`list_content_resources`	List the resources in a collection	Read
`create_content_resource`	Add a resource (link, video, or event reference)	Write
`edit_content_resource`	Update a content resource	Write
`delete_content_resource`	Permanently delete one content resource, leaving its collection intact	Destructive

Tool	What it does	Access
`list_tags`	List the community’s tags, grouped by tag group	Read
`create_tag`	Add a tag to an existing tag group	Write
`delete_tag`	Permanently delete a tag, removing it from everything it was on	Destructive

Custom fonts

Available on plans that include custom fonts. A font family is created empty, then one font file is attached to it per weight and style you want the site to render in — the same two steps as uploading a font in Studio. Deleting a face or a family deletes the font files behind it. Anything the site rendered in a deleted family reverts to the default typeface.

Tool	What it does	Access
`list_custom_font_families`	List the community’s custom font families and the faces in each	Read
`create_custom_font_family`	Create an empty custom font family	Write
`add_custom_font_face`	Attach an uploaded font file to a family as one weight and style	Write
`delete_custom_font_face`	Remove one weight and style from a family	Destructive
`delete_custom_font_family`	Delete a family, its faces, and their font files	Destructive

Branding

A branding set is a named collection of style tokens for your site, including its colors, typefaces, and corner roundness. Your site has one active branding set at a time which is applied. The rest are saved alternatives, so an agent can prepare a look and you apply it when you’re ready.

Tool	What it does	Access
`list_branding_sets`	List the community’s branding sets, including an indicator of the live branding set on the community site	Read
`create_branding_set`	Create a branding set, defaulting anything you don’t specify	Write
`edit_branding_set`	Change a branding set’s colors, fonts, shapes, or name	Write
`set_active_site_branding_set`	Apply a branding set to the site	Write
`delete_branding_set`	Delete a saved branding set that isn’t the active one	Destructive

Files

Several tools can attach an image you hold as a local file, such as an event cover, an award badge, a site logo, a group banner, or a content cover. The agent uploads the file with prepare_file_upload first, then passes the returned file id to the tool that uses it. Custom font files (.woff2 and .woff) go through the same two steps, then attach with add_custom_font_face. On the edit tools, every image parameter takes null to remove the image that is currently set. Omitting the parameter leaves the existing image alone. The same holds for optional text such as a description or a link: pass null to clear it, omit it to leave it as it is. Uploads are capped both by what the file is used for and by your plan’s file size limit, whichever is lower. prepare_file_upload states the cap it applied when it turns a file down.

Tool	What it does	Access
`prepare_file_upload`	Start an upload for a local image or font file and return an id to attach it with	Write

Let the agent reach the upload domain

The agent sends the file bytes itself, from its own sandbox, so that sandbox needs network access to mcp.tightknit.ai. This is a separate setting from the connector you already approved, and most clients restrict it by default. Claude desktop and claude.ai: unless your Domain allowlist is set to All domains, uploads fail until you add the Tightknit domain. Go to Settings > Capabilities, enter *.tightknit.ai under Additional allowed domains, and select Add. ChatGPT web and desktop: sandbox internet access is all or nothing rather than per domain. Turn on Allow public internet access under Settings > Data controls > Work network access. While it is off, the sandbox reaches only OpenAI’s own managed allowlist and uploads fail. This setting may be controlled by your workspace admin. Every other tool reaches Tightknit through the connector itself, so only file uploads need this.

Rate limits

Tool calls are limited per minute, per person, so one busy agent can’t slow things down for everyone else. Each tool draws on one of three budgets:

Budget	Per minute	Tools
Read	120	Fetching data, apart from the searches and activity log below
Write	60	Creating, updating, and deleting content, apart from the tools listed below
Expensive	20	`search_posts`, `search_comments`, `list_activities`, `give_award`, `add_group_members`, `prepare_file_upload`, `delete_group`, `delete_journey`, `delete_event`, `delete_award`, `remove_group_members`

Budgets are separate, so a run of searches never eats into what’s left for writes. A budget covers all the communities you administer rather than each one separately. There is also an overall cap of 300 requests a minute per connected agent. Limits are counted per region, so an agent spread across regions may get more than the figures above, never less. If your agent goes over a tool budget, the tool returns a message saying which one was exhausted. Going over the overall 300 cap instead fails at the connection level with an HTTP 429, which most clients report as a request error rather than a tool result. Either way, ask the agent to wait a minute and continue. Tools that take a list, such as give_award and add_group_members, cost one call no matter how many members you pass. Batching is cheaper against these limits than looping, but it does more at once, so keep the batches to what you actually intend to happen.

Troubleshooting

Access requires the MCP User role (or Admin) in a community that is in the pilot. Confirm you’re signing in with the right account, and ask Support to enable the MCP server for your community if it isn’t already.If sign-in completes and the client still reports a generic error with no tools, remove the connector and add it again. Some clients cache a failed handshake and keep replaying it.

The agent asks which community to use

If you can access more than one community, tools need to know which one to target. Ask the agent to run list_tenants and then reference the community by the tenant_id it returns.

The agent says it hit a rate limit

Each budget refills every minute. Ask the agent to wait and retry, or to batch its work: passing a list of members to give_award or add_group_members costs one call rather than one per member. See Rate limits for the budgets.

A file upload fails or times out

The agent uploads file bytes from its own sandbox, which needs network access to mcp.tightknit.ai. In Claude, add *.tightknit.ai under Settings > Capabilities > Additional allowed domains. In ChatGPT, turn on Allow public internet access under Settings > Data controls > Work network access. See Files for the full steps.

My client won't connect

The server uses the Streamable HTTP transport with OAuth. Make sure your client supports remote MCP servers (not only local stdio servers) and that you entered https://mcp.tightknit.ai/mcp exactly, including the /mcp path.

My client asks for an Auth URL, Token URL, or client secret

It doesn’t need them. Enter https://mcp.tightknit.ai/mcp and leave the OAuth fields blank: the server publishes its own metadata, and clients register themselves automatically, so there is no client ID or client secret to issue.If your client requires the values manually:

Field	Value
Authorization URL	`https://signin.tightknit.ai/oauth2/authorize`
Token URL	`https://signin.tightknit.ai/oauth2/token`
Registration URL	`https://signin.tightknit.ai/oauth2/register`
Authorization server base	`https://signin.tightknit.ai`
OIDC configuration URL	`https://signin.tightknit.ai/.well-known/openid-configuration`

CLI

Manage your community from the terminal with the Tightknit CLI.

API Keys

Generate keys for direct access to the Tightknit Admin API.

Getting Started

App Guides

Platform

Integrations

Support

Security

Let your agent set it up for you

Connection details

Connect your agent

How access works

Available tools

Communities

Events

Activity

Slack

Polls

Members

Posts and comments

Search

Feeds

Groups

Site

Onboarding

Journeys

Awards

Content library

Tags

Custom fonts

Branding

Files

Let the agent reach the upload domain

Rate limits

Troubleshooting

CLI

API Keys

​Let your agent set it up for you

​Connection details

​Connect your agent

​How access works

​Available tools

​Communities

​Events

​Activity

​Slack

​Polls

​Members

​Posts and comments

​Search

​Feeds

​Groups

​Site

​Onboarding

​Journeys

​Awards

​Content library

​Tags

​Custom fonts

​Branding

​Files

​Let the agent reach the upload domain

​Rate limits

​Troubleshooting

​Related

CLI

API Keys

Let your agent set it up for you

Connection details

Connect your agent

How access works

Available tools

Communities

Events

Activity

Slack

Polls

Members

Posts and comments

Search

Feeds

Groups

Site

Onboarding

Journeys

Awards

Content library

Tags

Custom fonts

Branding

Files

Let the agent reach the upload domain

Rate limits

Troubleshooting

Related