Can I use OAuth instead of an API key?

The hosted MCP tool takes a bearer token as authorization. A Tesselith API key with limited scopes is the simplest choice for your own agent.

Does this work with the OpenAI Agents SDK?

Yes. The Agents SDK's hosted MCP tool takes the same configuration as the Responses API mcp tool.

How much does it cost to call Tesselith tools?

Tesselith doesn't charge per tool call. Your OpenAI usage is billed by OpenAI, and posts count toward your Tesselith plan like any other.

OpenAI API + Tesselith

How to connect OpenAI API to Tesselith

Give your own OpenAI-powered agent Tesselith's tools with the Responses API's hosted MCP tool. OpenAI API talks to Tesselith’s MCP server, so it can draft, queue and schedule posts on every channel you’ve connected. Keep a human in the loop: publishing now and deleting always ask for your confirmation.

Join the waitlist MCP docs

What do I need before connecting?

You need an OpenAI API key, a Tesselith API key and a Tesselith workspace on Pro, Team or Agency (every new workspace starts with a 14-day Pro trial) with at least one channel connected. OpenAI calls Tesselith's MCP server for you, so there's nothing extra to host.

1 · Connect · a few minutes

Run this

agent.py

import os
from openai import OpenAI

client = OpenAI()
resp = client.responses.create(
    model="gpt-5",  # any model that supports remote MCP
    input="List my Tesselith channels",
    tools=[{
        "type": "mcp",
        "server_label": "tesselith",
        "server_url": "https://api.tesselith.com/mcp",
        "authorization": os.environ["TESSELITH_API_KEY"],
        "require_approval": "always",
    }],
)
print(resp.output_text)

authorization is sent as the bearer token on every request; OpenAI doesn't store it.

2 · Ask · live in Tesselith

Ask OpenAI API to post for you

Draft tomorrow's product tip for every connected channel.

Used Tesselith · list_channels · create_draft

Found 5 channels and created one draft tailored to each, saved in Tesselith for review.

Also try:

“Add every draft tagged launch to its channel's queue.”
“Which channels have nothing scheduled this week?”
“Upload this image URL and attach it to the Instagram draft.”

The setup at a glance

Create a Tesselith API key
Add the mcp tool to your request
Handle approvals
Test with a read-only call

One connection, every channel

Connect your accounts in Tesselith once. From then on OpenAI API can plan and schedule for any of them, and Tesselith publishes at the time you set, even after the conversation ends.

XSoon
Instagram
Facebook
LinkedInSoon
Threads
YouTube
TikTokSoon
DiscordSoon
Telegram
RedditSoon
PinterestSoon
Bluesky
Mastodon
Dev.toSoon
HashnodeSoon

How do I connect OpenAI API to Tesselith, step by step?

1. Create a Tesselith API key
In Tesselith, open Settings → Developers, create an API key and tick only the scopes the agent needs. Keys start with tsl_live_ and are shown once, so store it in your password manager or a secret store. Give an agent the smallest set of scopes that does the job, for example read posts and create drafts.

2. Add the mcp tool to your request

Pass the server URL and your key as authorization. Use allowed_tools to expose only the tools your agent needs, which also keeps token use down.

tool config

{
    "type": "mcp",
    "server_label": "tesselith",
    "server_url": "https://api.tesselith.com/mcp",
    "authorization": os.environ["TESSELITH_API_KEY"],
    "allowed_tools": ["list_channels", "create_draft", "add_to_queue"],
    "require_approval": {"never": {"tool_names": ["list_channels"]}},
}

3. Handle approvals
Approval is required by default. When the response contains an mcp_approval_request, show it to a person and reply with an mcp_approval_response. Skip approval only for read-only tools.
4. Test with a read-only call
Ask for your channels first. A list of your accounts means the key, scopes and URL are right.

What can OpenAI API do in Tesselith?

The server at https://api.tesselith.com/mcp exposes these tools. OpenAI API only gets the permissions you approve, and never more than your own role.

Tesselith MCP tools available to OpenAI API
	What it does
list_channels	Lists your connected accounts and their status
list_posts / get_post	Finds posts by status or channel, or reads one
get_queue	Shows a channel's upcoming posts and free slots
suggest_best_time	Suggests the next free slot and your best hours
get_analytics_summary	Counts active channels, drafts and published posts
create_draft	Drafts a post for one or more channels
update_post	Changes a post's text, channels or media
add_to_queue	Gives a post the channel's next free slot
schedule_post	Pins a post to an exact time
upload_media_from_url	Attaches an image or video from a public URL
publish_now	Publishes within a minute, only after you confirm
delete_post	Deletes a post, only after you confirm

Why is OpenAI API not working with Tesselith?

Almost every failure is one of these. Tesselith returns a readable error, so asking OpenAI API“what went wrong?” usually points at the right row.

Troubleshooting OpenAI API with Tesselith
	Fix
424 or "tool list failed"	OpenAI couldn't reach Tesselith or got a 401. Check the key is sent as authorization on every request.
The model calls tools you didn't want	Set allowed_tools to the tools the agent needs.
Responses stall waiting for approval	Answer the mcp_approval_request items, or use require_approval never for read-only tools.
403: your plan doesn't include API access	MCP is included on Pro, Team and Agency. New workspaces get a 14-day Pro trial; upgrade under Settings → Billing.
401: connection revoked or lost access	Someone disconnected the assistant in Settings → AI assistants, or your role changed. Connect again and approve the workspace.
The assistant can read posts but can't schedule	You unticked Schedule and queue on the consent screen. Disconnect and connect again, keeping that permission.
No channels found	The assistant only sees accounts already connected in Tesselith. Connect them under Channels first.
Post scheduled at the wrong time	Tell the assistant your time zone. Tesselith takes ISO 8601 times with an offset, and your workspace time zone is shown in get_queue.
429: rate limited	Each connection can make 120 requests a minute on Pro, 300 on Team and 600 on Agency. Wait for the Retry-After seconds.

OpenAI API and Tesselith: frequently asked questions

Can I use OAuth instead of an API key?: The hosted MCP tool takes a bearer token as authorization. A Tesselith API key with limited scopes is the simplest choice for your own agent.
Does this work with the OpenAI Agents SDK?: Yes. The Agents SDK's hosted MCP tool takes the same configuration as the Responses API mcp tool.
How much does it cost to call Tesselith tools?: Tesselith doesn't charge per tool call. Your OpenAI usage is billed by OpenAI, and posts count toward your Tesselith plan like any other.

OpenAI API’s own documentation: OpenAI docs.

Connect other AI agents

Claude Claude Code Claude Cowork ChatGPT Codex Cursor VS Code (GitHub Copilot)Windsurf Zed Cline Gemini CLI Hermes Agent OpenClaw Goose n8n Mistral Le Chat Perplexity Manus

Ready to connect OpenAI API?

Create your Tesselith account, connect your channels, and OpenAI API can start scheduling in minutes.

Join the waitlist

OpenAI API + Tesselith

How to connect OpenAI API to Tesselith

Join the waitlist MCP docs

What do I need before connecting?

1 · Connect · a few minutes

Run this

agent.py

import os
from openai import OpenAI

client = OpenAI()
resp = client.responses.create(
    model="gpt-5",  # any model that supports remote MCP
    input="List my Tesselith channels",
    tools=[{
        "type": "mcp",
        "server_label": "tesselith",
        "server_url": "https://api.tesselith.com/mcp",
        "authorization": os.environ["TESSELITH_API_KEY"],
        "require_approval": "always",
    }],
)
print(resp.output_text)

authorization is sent as the bearer token on every request; OpenAI doesn't store it.

2 · Ask · live in Tesselith

Ask OpenAI API to post for you

Draft tomorrow's product tip for every connected channel.

Used Tesselith · list_channels · create_draft

Found 5 channels and created one draft tailored to each, saved in Tesselith for review.

Also try:

“Add every draft tagged launch to its channel's queue.”
“Which channels have nothing scheduled this week?”
“Upload this image URL and attach it to the Instagram draft.”

The setup at a glance

Create a Tesselith API key
Add the mcp tool to your request
Handle approvals
Test with a read-only call

One connection, every channel

Connect your accounts in Tesselith once. From then on OpenAI API can plan and schedule for any of them, and Tesselith publishes at the time you set, even after the conversation ends.

XSoon
Instagram
Facebook
LinkedInSoon
Threads
YouTube
TikTokSoon
DiscordSoon
Telegram
RedditSoon
PinterestSoon
Bluesky
Mastodon
Dev.toSoon
HashnodeSoon

How do I connect OpenAI API to Tesselith, step by step?

1. Create a Tesselith API key
In Tesselith, open Settings → Developers, create an API key and tick only the scopes the agent needs. Keys start with tsl_live_ and are shown once, so store it in your password manager or a secret store. Give an agent the smallest set of scopes that does the job, for example read posts and create drafts.

2. Add the mcp tool to your request

Pass the server URL and your key as authorization. Use allowed_tools to expose only the tools your agent needs, which also keeps token use down.

tool config

{
    "type": "mcp",
    "server_label": "tesselith",
    "server_url": "https://api.tesselith.com/mcp",
    "authorization": os.environ["TESSELITH_API_KEY"],
    "allowed_tools": ["list_channels", "create_draft", "add_to_queue"],
    "require_approval": {"never": {"tool_names": ["list_channels"]}},
}

3. Handle approvals
Approval is required by default. When the response contains an mcp_approval_request, show it to a person and reply with an mcp_approval_response. Skip approval only for read-only tools.
4. Test with a read-only call
Ask for your channels first. A list of your accounts means the key, scopes and URL are right.

What can OpenAI API do in Tesselith?

The server at https://api.tesselith.com/mcp exposes these tools. OpenAI API only gets the permissions you approve, and never more than your own role.

Tesselith MCP tools available to OpenAI API
	What it does
list_channels	Lists your connected accounts and their status
list_posts / get_post	Finds posts by status or channel, or reads one
get_queue	Shows a channel's upcoming posts and free slots
suggest_best_time	Suggests the next free slot and your best hours
get_analytics_summary	Counts active channels, drafts and published posts
create_draft	Drafts a post for one or more channels
update_post	Changes a post's text, channels or media
add_to_queue	Gives a post the channel's next free slot
schedule_post	Pins a post to an exact time
upload_media_from_url	Attaches an image or video from a public URL
publish_now	Publishes within a minute, only after you confirm
delete_post	Deletes a post, only after you confirm

Why is OpenAI API not working with Tesselith?

Almost every failure is one of these. Tesselith returns a readable error, so asking OpenAI API“what went wrong?” usually points at the right row.

Troubleshooting OpenAI API with Tesselith
	Fix
424 or "tool list failed"	OpenAI couldn't reach Tesselith or got a 401. Check the key is sent as authorization on every request.
The model calls tools you didn't want	Set allowed_tools to the tools the agent needs.
Responses stall waiting for approval	Answer the mcp_approval_request items, or use require_approval never for read-only tools.
403: your plan doesn't include API access	MCP is included on Pro, Team and Agency. New workspaces get a 14-day Pro trial; upgrade under Settings → Billing.
401: connection revoked or lost access	Someone disconnected the assistant in Settings → AI assistants, or your role changed. Connect again and approve the workspace.
The assistant can read posts but can't schedule	You unticked Schedule and queue on the consent screen. Disconnect and connect again, keeping that permission.
No channels found	The assistant only sees accounts already connected in Tesselith. Connect them under Channels first.
Post scheduled at the wrong time	Tell the assistant your time zone. Tesselith takes ISO 8601 times with an offset, and your workspace time zone is shown in get_queue.
429: rate limited	Each connection can make 120 requests a minute on Pro, 300 on Team and 600 on Agency. Wait for the Retry-After seconds.

OpenAI API and Tesselith: frequently asked questions

Can I use OAuth instead of an API key?: The hosted MCP tool takes a bearer token as authorization. A Tesselith API key with limited scopes is the simplest choice for your own agent.
Does this work with the OpenAI Agents SDK?: Yes. The Agents SDK's hosted MCP tool takes the same configuration as the Responses API mcp tool.
How much does it cost to call Tesselith tools?: Tesselith doesn't charge per tool call. Your OpenAI usage is billed by OpenAI, and posts count toward your Tesselith plan like any other.

OpenAI API’s own documentation: OpenAI docs.

Connect other AI agents

Claude Claude Code Claude Cowork ChatGPT Codex Cursor VS Code (GitHub Copilot)Windsurf Zed Cline Gemini CLI Hermes Agent OpenClaw Goose n8n Mistral Le Chat Perplexity Manus

Ready to connect OpenAI API?

Create your Tesselith account, connect your channels, and OpenAI API can start scheduling in minutes.

Join the waitlist

What do I need before connecting?

Run this

Ask OpenAI API to post for you

The setup at a glance

One connection, every channel

How do I connect OpenAI API to Tesselith, step by step?

1. Create a Tesselith API key

2. Add the mcp tool to your request

3. Handle approvals

4. Test with a read-only call

What can OpenAI API do in Tesselith?

Why is OpenAI API not working with Tesselith?

OpenAI API and Tesselith: frequently asked questions

Connect other AI agents

Ready to connect OpenAI API?

What do I need before connecting?

Run this

Ask OpenAI API to post for you

The setup at a glance

One connection, every channel

How do I connect OpenAI API to Tesselith, step by step?

1. Create a Tesselith API key

2. Add the mcp tool to your request

3. Handle approvals

4. Test with a read-only call

What can OpenAI API do in Tesselith?

Why is OpenAI API not working with Tesselith?

OpenAI API and Tesselith: frequently asked questions

Connect other AI agents

Ready to connect OpenAI API?