Social data for your agent. One server, every endpoint a tool.
Openhandle gives your agent access to Instagram, TikTok, and X. Each API endpoint becomes one tool.
100 free requests, no card needed.
Connect
Add the server in one minute.
Pick your client. Sign in once in the browser, or pass an API key for scripts.
- 1
Add a custom connector
Open Settings, then Connectors, then Add custom connector. Paste the server URL.
Server URLhttps://api.openhandle.dev/mcp - 2
Approve in the browser
Openhandle opens in a tab and asks you to approve the connection. Pick Test or Live on that screen.
- 3
Ask for social data
The tools show up in the chat. Ask in plain words and the agent picks the right one.
“Find a public Instagram profile in the test data and show me its follower count and last three posts.”
The approval screen creates one API key named after the client, for example Claude (MCP). Disconnect a client under Settings, MCP server in the dashboard. That revokes the key and every token at once.
Tools
Every endpoint, one tool.
Tool names follow the operation IDs in the OpenAPI spec. Same inputs, same answer shape as the REST API.
Every public endpoint is available to your agent.
- Get a profile
- List profile posts
- List profile reels
- List profile videos
- List tagged posts
- and 40 more tools
TikTok
Every public endpoint is available to your agent.
- Get a profile
- List profile videos
- List liked posts
- List followers
- List following
- and 23 more tools
X
Every public endpoint is available to your agent.
- Get a profile
- List user posts
- List user replies
- List user media
- List followers
- and 12 more tools
Helpers for test data
These tools never use your request balance.
find_test_dataFind stable synthetic inputs by platform, operation, or trait. Unmetered.
get_test_dataGet one synthetic catalog entry by its stable ID. Unmetered.
Every result explains itself.
Every result carries the same metadata, so your agent can tell you what a call cost.
environmentrequestIdactualChargeliveEquivalentPricedatasetVersionWhat it costs
Same price as the REST API.
You pay per answered request, after use, with a cap you set. See the rates.
No MCP markup
A tool call costs the same as the matching REST call. There is no extra charge for MCP.
Older answers cost less
Cache hits cost $0.0005 at 24 hours and $0.0001 at 7 days. A 30-day cache hit is free.
Failed requests are free
Provider errors, our errors, invalid input, and rate limits cost nothing.
Test is always free
Every tool works on synthetic data in Test. The actual charge is always zero.
Connection
Approve once. Stay in control.
The browser handles sign-in. Your client gets a revocable connection.
A connection you control.
No API key copying for supported clients.
Add one server URL
Your client discovers the available tools and starts the connection.
Approve in your browser
Sign in to Openhandle and choose Test or Live. Your API key never enters the client.
Disconnect at any time
One action revokes the connection, its API key, and every token.
Protocol details
Secure defaults for every compatible client.
- Authorization
- OAuth 2.1 with PKCE
- Access token
- 1 hour
- Refresh token
- Rotates on use, 30 days
- Environment
- Chosen during approval
FAQ
MCP questions.
- Does it work with ChatGPT?
- Yes. Any client that speaks remote MCP over Streamable HTTP works. Paste the server URL in the connector settings, approve in the browser, and the tools show up in the chat.
- Do I need an environment setting?
- No. The credential picks Test or Live. With OAuth you choose on the approval screen. With an API key the key prefix decides. There is no environment argument, header, or setting.
- Can a script use it without OAuth?
- Yes. Send an API key as the bearer token in the Authorization header. Test keys start with oh_test_ and are never charged.
- Is the tool list the same as the REST API?
- Yes. Every public endpoint is one tool. The tool name comes from the operation ID, such as instagram_get_profile. Inputs and answers match the REST API.
- Where do I see what my agent spent?
- In the dashboard under Request history. MCP calls show up with channel mcp. Each row has the tool, the environment, and the charge.
Send your agent ahead.
Paste the prompt into your agent and it sets everything up. Or come yourself, it takes five minutes.