Skip to main content
Glama
maxhillaert

Attenza

by maxhillaert
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Attenza integrations

CI License: MIT

The public multi-host integration kit for Attenza. It contains only the client-side pieces needed to connect agents to Attenza: a CLI, one portable Agent Plugin, and focused setup notes per host.

The Attenza application, API implementation, database, deployment, and infrastructure remain in a separate private repository.

Integration status

Integration

Available now

Currently tested

Next step

Cursor remote MCP

packages/attenza-plugin/mcp.json points to the public OAuth endpoint

OAuth and MCP contract tested by Attenza; repository validation

Complete a real Cursor intervention round trip

Cursor Agent Plugin

packages/attenza-plugin plus a repository marketplace.json

Manifest/schema checks; local-test layout and marketplace skill/MCP paths

Desktop Customize or a team-marketplace install; then public marketplace submission

GrokBot custom connector

Shared OAuth endpoint works without a private URL

OAuth, tool discovery, intervention creation, human decision, and result retrieval tested end to end

Retain as the direct integration path

GrokBot plugin

The same Agent Plugin adds polling and expiry behavior to the MCP endpoint

Package validation; raw MCP round trip tested

Import this repo as a Cursor team marketplace (or wait for public listing) and install from GrokBot Plugins

ChatGPT / Codex

Native .codex-plugin manifest, required registered .app.json, bundled skills, and private repo marketplace

Developer-mode OAuth; complete package installed from the personal local marketplace with its skills and three MCP tools discovered in a clean session

Authenticate the local MCP client and complete an intervention round trip; use a managed workspace import for private cloud distribution

Claude Code

Native .claude-plugin manifest and repo marketplace

Manifest validation and repository discovery wiring

Install from the repo marketplace and complete an OAuth round trip

Attenza CLI

Browser OAuth, create, get, wait, cancel, and token refresh

Seven unit tests, clean wheel build, isolated install, and live production DCR + PKCE + token + authenticated tools/list smoke test

Complete a live create/wait intervention round trip

Cursor and GrokBot remain the end-to-end tested hosts. ChatGPT developer-mode OAuth and tool discovery are recorded; a ChatGPT/Codex package install plus intervention round trip, and Claude Code's live OAuth round trip, remain.

Related MCP server: Brainbase MCP

What every folder is for

Path

Why it exists

packages/attenza-plugin

Portable Agent Plugin: one manifest, one MCP config, shared skills, and A2UI authoring references. Hosts consume this directory.

.cursor-plugin

Cursor repository marketplace pointing at the shared package

.agents/plugins

ChatGPT/Codex repository marketplace pointing at the shared package

.claude-plugin

Claude Code repository marketplace pointing at the shared package

integrations/cursor

Human-facing Cursor setup and local test notes; not agent instructions

integrations/grokbot

Human-facing GrokBot publication status and test notes; not agent instructions

integrations/codex

ChatGPT/Codex installation and test notes

integrations/claude-code

Planned Claude Code overlay notes

src/attenza_cli

The dependency-free attenza command-line client

examples

Synthetic intervention payloads for testing

schemas

The public JSON shape accepted by the CLI

scripts

Repository boundary, manifest, and secret-leak checks

tests

CLI unit tests; they do not contact a live account

The CLI, examples, schemas, tests, and scripts stay at the repository root as siblings of the plugin package. .github, mise.toml, pyproject.toml, and the policy files are ordinary public-repository maintenance files.

Public endpoint

OAuth-capable MCP clients connect to:

https://www.attenza.io/mcp

The client discovers Attenza OAuth, opens sign-in and consent, and receives revocable user-scoped access. Do not publish API keys, OAuth tokens, authorization codes, or legacy capability URLs.

CLI

uv tool install git+https://github.com/maxhillaert/attenza-integrations.git
attenza login
attenza create examples/release-approval.json
attenza wait TASK_ID

The CLI stores its OAuth tokens only in the user's local configuration directory. Run attenza logout locally and revoke the connection in Attenza when it is no longer required.

Develop

mise install
mise run check

For a desktop Cursor plugin test, symlink or copy the portable package rather than the repository root. Desktop Cursor loads that folder from ~/.cursor/plugins/local. GrokBot and Cloud Agents do not; they install from a Cursor marketplace or an attached MCP server. See integrations/cursor and integrations/grokbot.

mkdir -p ~/.cursor/plugins/local
ln -sfn "$PWD/packages/attenza-plugin" ~/.cursor/plugins/local/attenza

Codex and Claude Code install from the public repository marketplaces:

codex plugin marketplace add maxhillaert/attenza-integrations
codex plugin add attenza@attenza-integrations

claude plugin marketplace add maxhillaert/attenza-integrations
claude plugin install attenza@attenza-integrations

See CONTRIBUTING.md and SECURITY.md before contributing.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessUnresponsive

Resources

Related MCP Connectors

Related MCP Servers

  • MCP Credentials Broker

    ars-system
    A
    license
    A
    quality
    F
    maintenance
    Provides secure OAuth2-based credential management for MCP servers, allowing agents to obtain short-lived token references without exposing raw secrets.
    7
    19 npm
    MIT

  • Brainbase MCP

    BrainbaseHQ
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables management of Brainbase agents, components, evals, tasks, and more via a remote MCP connection with OAuth authentication.
    2
    MIT

  • test-dcr-mcp-server

    LOUPZ-DE
    A
    license
    Not graded
    quality
    A
    maintenance
    A spec-compliant remote MCP server with built-in OAuth 2.1 and Dynamic Client Registration, enabling Notion Custom Agents to connect via 'Sign in with OAuth' without bearer tokens. It supports SSO federation to Google and Microsoft Entra, and includes basic tools like whoami, echo, and slow_task.
    MIT

  • scriptit

    shreyjindal81
    F
    license
    Not graded
    quality
    C
    maintenance
    Enables agents to connect to remote MCP servers once, access their tools through a compact MCP endpoint, pair a CLI inside sandboxes, and create watches that turn command or tool output into pollable structured events.
    2
    -