Skip to content

Latest commit

 

History

History
60 lines (43 loc) · 3.95 KB

README.md

File metadata and controls

60 lines (43 loc) · 3.95 KB

AgentStack — GPT (OpenAI) integration

Installable Agent Plugin for ChatGPT, Codex, and other Agent Plugins hosts (including Perplexity). The connector is remote Streamable HTTP at https://agentstack.tech/mcp. There is no local stdio server.

The server exposes one MCP tool, agentstack.execute. Action names come from the live /mcp/actions catalog. Sign-in is OAuth with dynamic client registration (/mcp/.well-known/oauth-register). Custom GPT Actions remain available for a GPT you configure yourself.

AgentStack is a full backend ecosystem: 8DNA hierarchical data, Rules Engine, Buffs (trials/subscriptions), Payments, and MCP tools for Projects, Auth, Scheduler, Analytics, Webhooks, Notifications, and Wallets.

What’s in this repo

Item Description
Remote MCP mcp.json — type: streamable-http, URL https://agentstack.tech/mcp, OAuth DCR. This is the connector ChatGPT, Codex, and Perplexity import.
OpenAPI schema openapi/agentstack-mcp.yaml — one action (execute MCP tool) for GPT Actions; supports API Key and OAuth2 auth modes.
Instructions GPT_INSTRUCTIONS.md — copy into your Custom GPT Instructions field.
Quick Start GPT_QUICKSTART.md — get API key, create Custom GPT, add Action, paste instructions.
Artifact layout ARTIFACTS.md — where each file lives and what it’s for.

Quick Start

  1. Install the plugin (ChatGPT, Codex, or Perplexity) so it connects to https://agentstack.tech/mcp. Steps: GPT_QUICKSTART.md and DIRECTORY_SUBMIT.md.
  2. Or, for a Custom GPT you configure yourself, get an API key — see GPT_QUICKSTART.md.
  3. Create a Custom GPT and add an Action with the OpenAPI schema; choose authentication mode:
    • API Key (X-API-Key) for service-style access.
    • OAuth2 (AgentStack as IdP) for end-user sign-in.
  4. Paste the instructions from GPT_INSTRUCTIONS.md.
  5. Use the GPT (e.g. “Create a project called Test”, “List my projects”).

What you can do

With the Custom GPT and Action configured, you can ask for any action exposed by the generated MCP capability matrix via agentstack.execute. Example prompts by domain:

Domain Example prompts
Projects "List my projects", "Get stats for my project", "Create a project named Test"
8DNA / Data "Store project data at key config.theme", "Read user data"
Rules Engine "Create a rule when user signs up", "List logic rules"
Buffs "Give user a 7-day trial", "List active buffs"
Payments "Create a payment", "Get wallet balance"
Auth "Get my profile", "Quick auth with email"
Scheduler, Analytics, Webhooks, Notifications, Wallets "Schedule a task", "Get analytics", "List webhooks"

Full tool list and parameters: MCP Capability Matrix. When to use which tool: CONTEXT_FOR_AI in the AgentStack repo.

Documentation

Links

License

MIT. See LICENSE.