Pickshot in your AI assistant (MCP)
Pickshot's MCP server lets an AI assistant make pictures, video and audio on your account, run the photo apps and keep your characters. It connects with an API key from the developers page, or with a Pickshot sign-in for apps that offer only that. Every generation costs credits, and a paid call has to carry a price cap.
What you need
- A Pickshot account with credits.
- An API key (make one on the API page and keep it private), or an app that offers a sign-in (OAuth) connection.
- For an API key: an MCP client that can send a request header. The setups below cover four.
The server
One address, standard MCP over HTTP. There is nothing to install on your side.
| Server address | https://pickshot.ai/mcp |
|---|---|
| Transport | Streamable HTTP (stateless, JSON replies) |
| Authorization | Authorization: Bearer <your API key>, or the sign-in (OAuth) connection below |
Set it up with an API key
Replace YOUR_PICKSHOT_API_KEY with your key. Keep it in an environment variable or a secret store where the app allows it, never in a file you share.
Claude Code
Run this once in a terminal:
claude mcp add --transport http pickshot https://pickshot.ai/mcp \
--header "Authorization: Bearer YOUR_PICKSHOT_API_KEY"Cursor
Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):
{
"mcpServers": {
"pickshot": {
"url": "https://pickshot.ai/mcp",
"headers": {
"Authorization": "Bearer YOUR_PICKSHOT_API_KEY"
}
}
}
}VS Code
Add it to .vscode/mcp.json in your project:
{
"servers": {
"pickshot": {
"type": "http",
"url": "https://pickshot.ai/mcp",
"headers": {
"Authorization": "Bearer YOUR_PICKSHOT_API_KEY"
}
}
}
}Claude Desktop through a bridge
If your app can only run a local program from its settings file, as Claude Desktop does, use a bridge that adds the header. This example uses the open-source mcp-remote package, which Pickshot does not make:
{
"mcpServers": {
"pickshot": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://pickshot.ai/mcp",
"--header",
"Authorization:${PICKSHOT_AUTH}"
],
"env": {
"PICKSHOT_AUTH": "Bearer YOUR_PICKSHOT_API_KEY"
}
}
}
}Any other client
Give it the server address and an Authorization header with the word Bearer, a space and your key. A client that offers only a sign-in (OAuth) connection can use the sign-in connection above instead.
Check the connection
From a terminal this should answer with the list of tools:
curl https://pickshot.ai/mcp \
-H "Authorization: Bearer $PICKSHOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Connect with a sign-in (OAuth)
Some assistants cannot send an API key and only offer a sign-in connection. Pickshot supports that too: you sign in to Pickshot in your browser and press Allow, and the app gets a short-lived token. It acts as you with the same reach as an API key, which means the same credit prices, limits and safety rules and nothing more.
- Give the app the server address above and choose its sign-in (OAuth) option. The app registers itself with Pickshot.
- Your browser opens a Pickshot page that names the app and the address it returns to. Check both: the app chose its own name.
- Press Allow, or Deny to refuse. Nothing is connected before you allow it.
- To end it, open the API page and disconnect the app under Connected apps. It stops at once.
ChatGPT
In ChatGPT, add Pickshot as a custom connector (an app, in developer mode) with the server address and choose OAuth. ChatGPT registers itself and sends you to Pickshot to allow it. Menu names change, so check ChatGPT's own help.
Claude
In Claude (claude.ai, Claude Desktop and the mobile apps), add a custom connector with the server address and leave the optional OAuth client ID and secret empty. Claude registers itself and sends you to Pickshot to allow it.
Claude Code
In Claude Code, add the server without a header, then run /mcp inside Claude Code and follow the steps in your browser:
claude mcp add --transport http pickshot https://pickshot.ai/mcpAny other MCP client that follows the MCP authorization specification (OAuth 2.1 with PKCE S256, dynamic client registration and the resource parameter) can connect the same way. Pickshot has not tested every client; if one does not connect, use an API key.
The tools
The assistant sees these tools. Those that only read cost nothing. Those that make something need a price cap and a stable key.
get_balance | Your credit balance and safety settings. |
|---|---|
confirm_adult | Kept for compatibility: since 2026-11-12 every account is at tier 2, so there is nothing to confirm (it answers not_available). |
list_models | The models open for your account, with modes, limits and prices. |
estimate_cost | The exact price of a request. Never charges. |
create_image | Makes a picture or an edit, within the cap you set. |
create_video | Makes a clip and returns a job. |
create_audio | Makes speech, music or a sound effect and returns a job. |
get_job | Status and result of a job you started. |
list_apps | The photo apps, their fields and their price. |
run_app | Runs a photo app on pictures you link, within the cap. |
list_characters | Your saved characters and their reference pictures. |
create_character | Saves a character from your pictures, only with your consent. |
delete_character | Deletes one saved character. |
get_usage | What this key and account have really used. |
How spending stays in your hands
- Every generation costs credits, including models that are free on the website. There is no free trial through a key.
- A paid call needs max_credits. The assistant asks for the price first, and a higher price is refused before anything is taken.
- Each paid call carries a stable key, so a retry after a timeout returns the first result instead of charging again.
- Make a separate key for each app and revoke it on the API page whenever you like. An app connected with a sign-in is disconnected the same way, under Connected apps. The Usage tab shows what each key has done.
What it cannot do yet
- Sign-in connection: apps register by dynamic client registration (Client ID Metadata Documents are not supported yet), return addresses must be https or localhost, and a connection nobody uses for 30 days ends. One member can keep up to 3 apps connected at once: to connect another, disconnect one on the API page, under Connected apps.
- Results are private to your account. Share them yourself.
Întrebări
Does MCP cost extra?
No extra fee. The tools that only read are free. Making something costs credits at the API price.
Which assistants work?
With an API key: any MCP client that supports remote servers over HTTP and lets you set a request header. The setups above cover Claude Code, Cursor, VS Code and Claude Desktop through a bridge. With a sign-in: ChatGPT and Claude, including Claude Code, whose connector flows use OAuth with dynamic client registration, which Pickshot offers. Other clients that follow the MCP authorization specification may work too; Pickshot has not tested them all.
Can the assistant spend without asking?
It can only spend what its own max_credits allows, so tell it your budget. What really bounds it is the credits on your account and a key you can revoke at any time. The skills make an assistant ask before it spends.
Where do I see what was made?
Pictures are in your library, marked as made through the API. The Usage tab on the API page counts every call and run.