Connect & develop

Connect an AI assistant to this app's MCP server, or build on papagen.io with the REST API, JavaScript SDK, and admin CLI.

MCP server

Any AI assistant that supports streamable HTTP MCP servers can use this app — the assistant then acts as you, with your app account and permissions. Start by copying the server URL below.

MCP server URL

https://papagen.io/api/mcp

Claude

  1. 1Open the profile menu → Settings → Connectors.
  2. 2Click "Add custom connector".
  3. 3Give it a name and paste the server URL, then click Add.

ChatGPT

  1. 1Go to Apps and enable Developer mode (note: ChatGPT warns that developer-mode apps can send your conversation data to the app — this applies here too).
  2. 2Click "Create app", give it a name, and paste the server URL.
  3. 3Click Create, then enable the app from the chat composer before prompting it.

Cursor

  1. 1Open Settings → Tools & Integrations → "New MCP Server". This opens mcp.json.
  2. 2Add an entry whose "url" is the server URL above, then save.
  3. 3Toggle the server on.

Using the /ok-tucano skill (Claude Code)

If you use Claude Code, you can skip manual setup and use our /ok-tucano skill. You enter a topic and your prompt, and it gives you the matching papagen.io URL with your input already filled in.

  1. 1Install the MCPmarket plugin in Claude Code: claude plugin marketplace add knoxgraeme/mcpmarket-plugin — or download the pre-configured ZIP from the MCPmarket dashboard.
  2. 2Configure it with the toolkit URL and your API token (starts with sk_user_, from the MCPmarket dashboard or the ZIP).
  3. 3Restart Claude Code — the skill syncs automatically when a session starts.
  4. 4Run the skill with a topic and your prompt, e.g. /ok-tucano ai:explain transformer architecture
  5. 5It returns a papagen URL like https://papagen.io/ai?kw=explain%20transformer%20architecture — open it and the topic loads with your input ready to submit.

The part before the colon is the topic (one of the keywords from this app), the part after is your prompt. Skills sync automatically when you start, resume, clear, or compact a Claude Code session — if the skill isn't found, restart Claude Code.

Custom client

  1. 1Copy the server URL above.
  2. 2Add it as a streamable HTTP MCP server — a name and the URL is all most clients need.
  3. 3Reload the client so the tool list appears.

Signing in

This server requires sign-in. After you add it, the assistant opens this app's consent page, where you sign in with your own app account and approve access — the assistant only ever acts as you.

After we ship changes

Assistants cache the tool list. If the app's tools change, refresh or re-add the connector in your assistant so it picks up the latest tools.

Note: you'll need an app account to approve access in the last step.

REST API

Call the app's backend functions over HTTPS with a wallet-verified agent key (pga_…) or an admin session token. The full reference — parameters, response fields, and every endpoint — lives on the API docs page.

curl -X POST https://papagen-io.base44.app/functions/generateOutput \
  -H "Content-Type: application/json" \
  -H "X-API-Key: pga_YOUR_AGENT_KEY" \
  -d '{ "keyword": "solar panels", "topic_label": "Security" }'

JavaScript SDK

A zero-dependency JavaScript client for the papagen.io MCP server. Works with Node.js 18+ or any runtime with fetch. Copy the sdk/ folder from the repo into your project and initialize with an access token.

import { PapagenClient } from './sdk/index.js';

const client = new PapagenClient({
  accessToken: process.env.PAPAGEN_ACCESS_TOKEN,
});

const result = await client.generateOutput({
  keyword: 'phishing red flags',
  topic_label: 'Security',
  mode: 'search',
});
console.log(result.output, result.request_id);

Admin CLI

A small, zero-dependency Node.js CLI for admins and machines. It authenticates with a wallet-verified agent key (pga_…) that an admin has flagged is_admin in the Agents panel.

Install

# from the repo's cli/ folder
npm install -g .        # exposes the papagen command
# or run directly:
node cli/index.js <command>

Authenticate

papagen auth --address 0xYOUR_WALLET
# 1) the CLI prints a message  2) sign it in your wallet  3) paste the signature
# the pga_… key is saved to ~/.papagen/credentials.json and reused by every command

Commands

auth [--address 0x…]Wallet handshake — get a pga_… agent key
generate --topic <label> --kw <text>Generate output for a keyword
notebookEmit the notebook trigger marker
housekeepingRun full housekeeping (all topics)
housekeeping-category --category <slug>Run housekeeping for one category
refresh-dashboardRebuild the Cineribus cache
request <id>Decrypt a stored output (admin/submitter)
statusApp integration health

The CLI calls the same endpoints as the REST API. A pga_… key that is not flagged admin gets 403 on admin commands — an admin can revoke it per-agent from the Agents panel.