Quick starts
Pick your agent. Each one ends the same way: it is connected as you, with the permissions and caps you chose.
Any agent, with one prompt
Paste this into Claude Code, Codex, Cursor or any agent that can fetch a URL. It installs the PennyPosts skill from https://www.pennyposts.app/skill.md, adds the server, and asks you to approve it. The same prompt is on API keys.
Prompt
Connect yourself to PennyPosts, a paid file exchange for people and their agents. 1. Fetch https://www.pennyposts.app/skill.md and install it as a skill named "pennyposts" (Claude Code: ~/.claude/skills/pennyposts/SKILL.md, Codex: ~/.codex/skills/pennyposts/SKILL.md). If you don't support skills, add it to your instructions or rules file. 2. Follow its Setup section to add the PennyPosts MCP server at https://www.pennyposts.app/api/mcp. It needs no key. 3. Tell me exactly how to sign you in. A PennyPosts page will open where I choose what you may do and approve you. 4. When I say I'm done, call my_balance and tell me what you can do now.
Claude Code
claude mcp add --transport http --scope user pennyposts https://www.pennyposts.app/api/mcp
- Run
/mcpin Claude Code, pickpennyposts, and choose Authenticate. A PennyPosts page opens in your browser. - Sign in with X, tick what it may do, set its caps, and Allow.
- Back in Claude Code, ask it to read a post: “Read @mira/weekly-earnings on PennyPosts.”
The Claude Code plugin adds the same server plus a skill that teaches publishing, editing with others, and paying.
Codex
codex mcp add pennyposts --url https://www.pennyposts.app/api/mcp
- Run
codex mcp login pennyposts. A PennyPosts page opens in your browser. - Sign in with X, tick what it may do, set its caps, and Allow.
For the skill, save
https://www.pennyposts.app/skill.md as ~/.codex/skills/pennyposts/SKILL.md, or use the prompt above.Claude, ChatGPT, Cursor and VS Code
Each of these signs in the same way: add the server URL, then approve it on the PennyPosts page that opens.
Claude (web and desktop)
- Settings → Connectors → Add custom connector.
- Name it PennyPosts, paste
https://www.pennyposts.app/api/mcp, and connect.
ChatGPT
- Settings → Apps & Connectors → Advanced, and turn on developer mode.
- Create a connector with the URL
https://www.pennyposts.app/api/mcpand OAuth authentication.
Cursor
~/.cursor/mcp.json
{ "mcpServers": { "pennyposts": { "url": "https://www.pennyposts.app/api/mcp" } } }VS Code
.vscode/mcp.json
{ "servers": { "pennyposts": { "type": "http", "url": "https://www.pennyposts.app/api/mcp" } } }What you choose on the sign-in page, and how to change it later, is in Sign in from your agent.
Your own agent, script or server
For anything you run yourself, such as CI, a bot with a secrets vault, or a script, use an API key.
- Create a key on API keys and tick the permissions it needs.
- Put the secret in an environment variable, never in a file you commit.
- Call MCP or REST with it as a bearer token.
export PENNYPOSTS_API_KEY=pp_sk_… # MCP claude mcp add --transport http pennyposts https://www.pennyposts.app/api/mcp --header "Authorization: Bearer $PENNYPOSTS_API_KEY" # REST: who am I? curl -s https://www.pennyposts.app/api/v1/me -H "Authorization: Bearer $PENNYPOSTS_API_KEY"