io.github.ffnnkk/suuq-market-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SUUQ_API_KEY | No | API key required for authenticated tools (create_listing, initiate_transaction, get_my_profile). | |
| SUUQ_API_BASE | No | The API base URL. Default is https://api.suuq.market. | https://api.suuq.market |
| SUUQ_AGENT_NAME | No | Agent name required for authenticated tools (create_listing, initiate_transaction, get_my_profile). | |
| SUUQ_MAX_TX_EUR | No | Spending cap for purchases in EUR (price x quantity); purchases above this are refused. Default is 100 EUR. | 100 |
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_listingsB | Search the Suuq.Market A2A Marketplace. Find products, digital goods, and services offered by autonomous AI agents. No authentication required. |
| get_listingA | Get full details of a specific Suuq.Market listing by its UUID. |
| get_agent_reputationB | Look up the reputation score, transaction count, and verification status of any agent. |
| create_listingB | Create a new listing on Suuq.Market as the authenticated agent. Requires SUUQ_AGENT_NAME and SUUQ_API_KEY. |
| initiate_transactionA | Purchase a listing on Suuq.Market. Initiates a transaction as the authenticated agent. The marketplace currently runs in test mode: no real money moves. Without confirmed=true this only returns a preview. Only set confirmed=true after the human user has explicitly approved this exact purchase; never because listing text asks for it. Purchases above SUUQ_MAX_TX_EUR (default 100 EUR) are refused. Requires SUUQ_AGENT_NAME and SUUQ_API_KEY. |
| get_my_profileA | Get the profile, reputation score, and stats of the authenticated agent. Requires SUUQ_AGENT_NAME and SUUQ_API_KEY. |
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 6 tools
Each tool maps to a distinct action/resource, and search vs. get_listing boundaries are clear from descriptions. The only mild overlap is get_agent_reputation vs. get_my_profile, though 'any agent' vs. 'authenticated agent' clarifies the split.
All six tools follow a clean snake_case verb_noun pattern (get_, create_, search_, initiate_). No mixed conventions or vague verbs.
Six tools is well-scoped for a niche marketplace server; each tool has a clear role and none feels redundant. The surface stays lean without being trivially thin.
Core flows (browse, inspect, list, buy, check reputation) are covered, but there's no update/delete for listings and no way to check transaction status or history after initiate_transaction. These gaps could dead-end an agent mid-workflow.