a4sx-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| A4SX_BASE | No | The a4sx server to connect to (equivalent to the --base URL option). Default: the one you signed in to, else https://session-exchange.com. Plain http is refused except for localhost. | |
| A4SX_MCP_LOG | No | Log level: warning (default), info or debug. Logs go to stderr and contain tool names, outcomes and durations only: never arguments, transcripts or tokens. | warning |
| A4SX_SESSION | No | A token to use instead of the stored sign-in (for CI). | |
| A4SX_CONFIG_DIR | No | Where the a4sx CLI keeps its sign-in (default ~/.config/a4sx, %APPDATA%\a4sx on Windows). | |
| A4SX_MCP_PER_MIN | No | Local overall request rate limit per minute (default 240). 0 turns the local limit off. | 240 |
| A4SX_SESSION_BASE | No | The server the A4SX_SESSION token belongs to. Default: https://session-exchange.com. | |
| A4SX_MCP_ACQUIRE_PER_MIN | No | Local acquire rate limit per minute (default 20). 0 turns the local limit off. | 20 |
| A4SX_MCP_PUBLISH_PER_MIN | No | Local publish rate limit per minute (default 10). 0 turns the local limit off. | 10 |
| A4SX_MCP_MAX_PUBLISH_BYTES | No | Lower or raise the 2 MiB publish_session cap (the server may still refuse larger uploads). |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_sessionsA | Search vetted, published coding-agent sessions on a4sx (reviewed marketplace listings), or your own saved sessions with scope=library. Returns ids to use with the other tools. |
| get_session_summaryA | Describe one session before using it: what it did, outline, price, and whether you already have access. source=marketplace (default) or library. |
| acquire_sessionA | Add a marketplace session you are entitled to (free, bought, or granted) to your private library. Never buys anything: for a paid listing it returns status=payment_required with the price and the listing URL. |
| fetch_session_contextA | Load a session from your library (saved, or added with acquire_session) as starting context for this conversation, sized to max_tokens. |
| publish_sessionA | Save a session transcript (JSONL) to your private a4sx library. The server scrubs token-shaped secrets before storing. Private: it is never listed publicly by this tool. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Each tool occupies a distinct stage of the session workflow: search finds IDs, get_session_summary inspects, acquire_session adds to library, fetch_session_context loads it, and publish_session stores transcripts. The descriptions explicitly clarify boundaries (e.g. acquire never buys, publish is private), leaving no realistic confusion.
All five tools follow a consistent snake_case verb_noun pattern (search_, get_, acquire_, fetch_, publish_ + noun). Verb choices are predictable and readable with no mixed conventions.
Five tools cleanly map to the discover-inspect-acquire-load-publish lifecycle of a session marketplace/library. Nothing feels redundant or missing for the stated scope.
The full core workflow is covered: search, inspect, acquire, load context, and publish. Minor gaps exist, such as no explicit tool to remove or manage library entries or list one's own library contents beyond scope=library search, but agents can work around these.