A2A Peptides

Official20 tools

by A2A-Peptides · Python

Agent-to-Agent (A2A) + Model Context Protocol (MCP) hub for peptides.

io.github.A2A-Peptides/a2a-peptides MCP Server

Agent-to-Agent (A2A) plus Model Context Protocol (MCP) hub for peptides. It provides an A2A surface for peptide data served over MCP, described as a “record” and “registry for security,” and includes “x402 to pay on it,” for authorized trading partners. Operated by GreenCore Solutions Corp.

🛠️ Key Features

Agent-to-Agent (A2A) hub for peptides
Model Context Protocol (MCP) surface for peptides
Security-focused “record” and “registry”
x402 payment on the MCP record

🚀 Use Cases

Authorized trading partners for peptide trading via A2A
Accessing a catalog of peptide products and licensed providers

⚡ Developer Benefits

Standardized MCP interface for peptide-related integrations
Structured coverage: 5,301 peptide products and 24,694 licensed peptide providers

⚠️ Limitations

Claims only limited operational details in the provided excerpt (no specific MCP tools, schemas, or interfaces listed)

Topics

a2aagent-cardagent-to-agentagentic-commerceai-agentsazurecloudflarecosmeticsglp-1mcpmcp-servermodel-context-protocolpeptidespharmapharmacyregulatory-datasupplementsx402

Captured live from the server via tools/list.

resolve_jurisdiction

Resolve a ship-to (e.g. 'US-CA', 'CA-ON', 'MX', 'EU-DE', 'UK', 'KR', 'JP', 'SG', 'CH') to the gate's jurisdiction (US · CA · MX · EU · UK · KR · JP · SG · CH; UK is the jurisdiction name; the ISO 3166-1 code is accepted as input, machine fields carry the ISO code and jurisdiction_label carries UK), the EU member and any state, provincial or cantonal overlay.

Parameters1

ship_to

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "ship_to": {
      "type": "string"
    }
  },
  "required": [
    "ship_to"
  ]
}

resolve_actor

Resolve the actor class and channel. Classes: authorized_trading_partner and its members (manufacturer · repackager · wholesale_distributor · dispenser · third_party_logistics_provider; cosmetic_responsible_person · nhp_licence_holder on the non-drug pathways), prescriber, the referral classes patient and public, and agent (inherits the class of the credential it presents; none returns DENY_UNLICENSED_AGENT). Returns communication_class: trade_information or public.

Parameters2

actor_class	string	required
credential	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "actor_class": {
      "type": "string"
    },
    "credential": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "actor_class"
  ]
}

gate_transaction

The gate: allow, deny or require_rx for a substance (name, INN or unii:), a pathway (licensed_medicine · lawful_compounding · cosmetic · food_or_supplement · ruo_not_cleared), an actor class, a channel and a ship-to. Returns a frozen reason code, the rule-set version, the source page and a decision_id for the downstream tools.

Parameters6

substance	string	required
pathway	string	required
actor_class	string	required
ship_to	string	required
channel	any	optional
credential	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "substance": {
      "type": "string"
    },
    "pathway": {
      "type": "string"
    },
    "actor_class": {
      "type": "string"
    },
    "ship_to": {
      "type": "string"
    },
    "channel": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "credential": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "substance",
    "pathway",
    "actor_class",
    "ship_to"
  ]
}

get_substance_record

One molecule: identifiers (INN, UNII, CAS, sequence hash), sourced aliases, class, one pathway row per jurisdiction × pathway, enforcement events, safety references. Every field carries its source page.

Parameters1

substance

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "substance": {
      "type": "string"
    }
  },
  "required": [
    "substance"
  ]
}

get_pathway_status

The status of a substance on one pathway in one jurisdiction (frozen vocabulary), with effective date, rule-set version and source page.

Parameters3

substance	string	required
jurisdiction	string	required
pathway	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "substance": {
      "type": "string"
    },
    "jurisdiction": {
      "type": "string"
    },
    "pathway": {
      "type": "string"
    }
  },
  "required": [
    "substance",
    "jurisdiction",
    "pathway"
  ]
}

get_compounding_eligibility

Whether a substance may be lawfully compounded in a jurisdiction and under which list or standard (503A/503B, provincial, magistral, Specials), from the register.

Parameters2

substance	string	required
jurisdiction	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "substance": {
      "type": "string"
    },
    "jurisdiction": {
      "type": "string"
    }
  },
  "required": [
    "substance",
    "jurisdiction"
  ]
}

get_label_and_indication

Label and indication pointers for a licensed presentation only (US package NDC, CA DIN, EU EMA number).

Parameters1

presentation_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "presentation_id": {
      "type": "string"
    }
  },
  "required": [
    "presentation_id"
  ]
}

get_enforcement_watch

Dated, URL'd enforcement events for a substance or jurisdiction: warning letters, import alerts, shortage-list changes, committee votes, proposed and final rules, seizures, state notices.

Parameters3

substance	any	optional
jurisdiction	any	optional
since	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "substance": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "jurisdiction": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "since": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  }
}

search_cleared_items

Presentations that passed the gate for a jurisdiction, pathway and actor class (a query by substance, brand or holder; optional banner filter on the shelf of record). Only cleared statuses are returned; every item carries its availability block (banners, pos_count, product_urls).

Parameters7

query	string	required
jurisdiction	string	required
pathway	string	optional
actor_class	string	optional
limit	integer	optional
decision_id	any	optional
banner	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "jurisdiction": {
      "type": "string"
    },
    "pathway": {
      "default": "licensed_medicine",
      "type": "string"
    },
    "actor_class": {
      "default": "wholesale_distributor",
      "type": "string"
    },
    "limit": {
      "default": 25,
      "type": "integer"
    },
    "decision_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "banner": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "query",
    "jurisdiction"
  ]
}

get_item

One authorised presentation by id (US package NDC, CA DIN, EU EMA number, KR MFDS item seq, CH Swissmedic authorisation/pack code, JP approved-list entry, or the catalogue id): brand, strength, form, route, device, pack, holder, status, offers (tenant is a parameter).

Parameters3

presentation_id	string	required
tenant	any	optional
decision_id	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "presentation_id": {
      "type": "string"
    },
    "tenant": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "decision_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "presentation_id"
  ]
}

compare_presentations

Compare two or more authorised presentations side by side (ids as for get_item).

Parameters2

presentation_ids	array	required
decision_id	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "presentation_ids": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "decision_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "presentation_ids"
  ]
}

find_licensed_supplier

Licensed parties for a presentation in a jurisdiction (tenant as a parameter). Takes the decision_id of an allow or require_rx decision from gate_transaction.

Parameters4

presentation_id	string	required
jurisdiction	string	required
decision_id	string	required
tenant	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "presentation_id": {
      "type": "string"
    },
    "jurisdiction": {
      "type": "string"
    },
    "decision_id": {
      "type": "string"
    },
    "tenant": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "presentation_id",
    "jurisdiction",
    "decision_id"
  ]
}

get_availability

Availability of a presentation once gate_transaction has answered allow or require_rx (decision_id): the availability block — banners[] on the shelf of record with licence footnote, pos_count (chain points of sale from the CPG Knowledge Graph retailer registry, or licensed dispensers on the provider directory for medicines), product_urls[] (retailer product page, register page, holder page) — plus tenant offers.

Parameters3

presentation_id	string	required
decision_id	string	required
tenant	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "presentation_id": {
      "type": "string"
    },
    "decision_id": {
      "type": "string"
    },
    "tenant": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "presentation_id",
    "decision_id"
  ]
}

get_price

Price basis (list · contract · reimbursement) from a licensed party, once gate_transaction has answered allow or require_rx (decision_id).

Parameters3

presentation_id	string	required
decision_id	string	required
tenant	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "presentation_id": {
      "type": "string"
    },
    "decision_id": {
      "type": "string"
    },
    "tenant": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "presentation_id",
    "decision_id"
  ]
}

get_lot_coa

Certificate of analysis for a lawful lot of a presentation, where the pathway permits (decision_id required).

Parameters3

presentation_id	string	required
lot	string	required
decision_id	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "presentation_id": {
      "type": "string"
    },
    "lot": {
      "type": "string"
    },
    "decision_id": {
      "type": "string"
    }
  },
  "required": [
    "presentation_id",
    "lot",
    "decision_id"
  ]
}

verify_serialization

Verify a serialised pack (GTIN + serial + lot + expiry) against the serialisation regime of the jurisdiction (DSCSA · FMD · UK · KR; none-national elsewhere).

Parameters5

jurisdiction	string	required
gtin	string	required
serial	string	required
lot	any	optional
expiry	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "jurisdiction": {
      "type": "string"
    },
    "gtin": {
      "type": "string"
    },
    "serial": {
      "type": "string"
    },
    "lot": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "expiry": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "jurisdiction",
    "gtin",
    "serial"
  ]
}

create_order_intent

Create an order intent for a cleared item after the gate; the intent carries reason_code + rule_set_version and settles by x402 on peptides-x402.ai.

Parameters5

presentation_id	string	required
quantity	integer	required
decision_id	string	required
tenant	any	optional
ship_to	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "presentation_id": {
      "type": "string"
    },
    "quantity": {
      "type": "integer"
    },
    "decision_id": {
      "type": "string"
    },
    "tenant": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "ship_to": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "presentation_id",
    "quantity",
    "decision_id"
  ]
}

a2a_handoff

Hand off over Agent-to-Agent (A2A). With an allow/require_rx decision: the order intent goes to the licensed counterparty's agent (envelope + card URL). With a deny for a patient, the public or an unauthorized actor: returns real licensed destinations from the provider directory (dispensers, prescribers) filtered by the decision's jurisdiction, state/province and practice scope — a referral, never a vial.

Parameters5

intent_id	any	optional
decision_id	any	optional
counterparty_card_url	any	optional
practice_scope	any	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "intent_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "decision_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "counterparty_card_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "practice_scope": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "limit": {
      "default": 10,
      "type": "integer"
    }
  }
}

get_safety_label

Safety label pointers for licensed products (label page and the pharmacovigilance scheme of the jurisdiction).

Parameters2

substance	string	required
jurisdiction	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "substance": {
      "type": "string"
    },
    "jurisdiction": {
      "type": "string"
    }
  },
  "required": [
    "substance",
    "jurisdiction"
  ]
}

log_audit

Write the audit line for a gate decision or an order intent (returns the line id).

Parameters3

kind	string	required
reference_id	string	required
note	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string"
    },
    "reference_id": {
      "type": "string"
    },
    "note": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "kind",
    "reference_id"
  ]
}

README.md9 KBView on GitHub

A2A Peptides — the first agentic commerce hub for peptides in 35 countries

Agent-to-Agent (A2A) + Model Context Protocol (MCP) hub for peptides.

The Agent-to-Agent (A2A) surface for peptides, served over the Model Context Protocol (MCP) — the record, a registry for security, and x402 to pay on it. AI agents for authorized trading partners. Not marketing. Not advertising. Operated by GreenCore Solutions Corp.

Six frontier AI labs in the build — Anthropic, OpenAI, Google, Perplexity, xAI, Mistral — 10K agent requests a day.
5,301 peptide products.
24,694 licensed peptide providers.
35 countries — runs on Cloudflare, Amazon, Microsoft and Google hyperscalers.
First agentic commerce hub for peptides on the Model Context Protocol (MCP) registry.

Connect: https://mcp.a2a-peptides.ai/mcp — streamable-HTTP, no adapter. Hub: https://a2a-peptides.ai/ · llms.txt · Agent Card

Connect kit

Agent-to-Agent (A2A) + Model Context Protocol (MCP) hub for peptides. AI agents for authorized trading partners. Not marketing. Not advertising. Operated by GreenCore Solutions Corp.


Hub	https://a2a-peptides.ai/ · setup · docs · llms.txt
MCP door of record	`https://mcp.a2a-peptides.ai/mcp` — streamable-HTTP, stateless, server name `a2a-peptides`, door version 1.6.7, 20 tools (read from the wire 2026-09-19)
A2A endpoint	`https://<hostname>/a2a` on every agent — A2A 0.3.0 JSON-RPC, `message/send` and `tasks/get`; the preferred interface on every card
Agent Card	https://a2a-peptides.ai/.well-known/agent-card.json — signed ES256, kid `a2ap-2026-09`
Keyring	https://a2a-peptides.ai/.well-known/jwks.json
Issuer	https://peptides-registry.ai/.well-known/oauth-authorization-server — client-credentials Bearer for the transacting skills; reads need none
Auditor Port	https://audit.a2a-peptides.ai/packs/index.json — the public index of sealed review packs
Registry	namespace `io.github.A2A-Peptides` (the registry grants the GitHub login case), server `a2a-peptides` — server.json
Family	hub · peptides-registry.ai (registry) · peptides-x402.ai (payments door) · a2a-pharma.ai (pharma gate) · peptides-usa.ai (first tenant)

Agents (A2A)

Every agent lives at its own hostname and answers two addresses: https://<hostname>/.well-known/agent-card.json (the signed card) and https://<hostname>/a2a (A2A 0.3.0 JSON-RPC: message/send, tasks/get). There is no inference behind the endpoint. A DataPart {"skill": ..., "params": {...}} runs the gate chain on the door — resolve_jurisdiction → resolve_actor → gate_transaction — and then the skill; the artifact carries the result, the notice, the resolved jurisdiction and the rule-set version. A plain text part gets the deterministic skill list with each input schema. A text part whose text is a JSON object with a skill key is read as the same {skill, params} request, so text-only clients can send structured requests too. Transacting skills take the issuer's Bearer; without it the answer is DENY_UNLICENSED_AGENT.

Role	Hostname	Agents	Region
Hub (concierge)	a2a-peptides.ai	1	South Central US
Registry (token questions)	peptides-registry.ai	1	South Central US
Payments door (receipt questions)	peptides-x402.ai	1	South Central US
Country agents	country code + .a2a-peptides.ai (the United Kingdom is uk; the European Union level is eu)	36	South Central US
Actor-class entry points	pharmacy · prescriber · wholesaler · brand + .a2a-peptides.ai	4	South Central US
Pharma gate	a2a-pharma.ai	1	South Central US
Handoff (referral only)	handoff.a2a-peptides.ai	1	South Central US
Enforcement watch	watch.a2a-peptides.ai	1	South Central US
Auditor Port	audit.a2a-peptides.ai	1	South Central US
Tenant concierge	peptides-usa.ai	1	South Central US
State and territory agents	us- + state or territory code + .peptides-usa.ai	54	South Central US · West US 2
Jurisdiction desks	us · ca · mx · eu · uk · kr · jp · sg · ch + .peptides-usa.ai	9	South Central US

111 agents live, 36 product-line slots reserved on the tenant table; by region: South Central US 97 · West US 2 14. Counted from the hub's list_agents on 2026-09-19; door version 1.6.7, 20 tools.

Human-readable text on every card says UK; the machine field carries the ISO code. A country agent's hostname is the country code in lower case (the United Kingdom is uk, Germany is de, and the European Union level is eu) before .a2a-peptides.ai.

The gate

Three calls come before any price, availability, order or handoff: resolve_jurisdiction → resolve_actor → gate_transaction. The gate returns allow, deny or require_rx with a frozen reason code and the version of the rule set it read; both travel on every downstream receipt, including x402 settlement receipts.

Jurisdictions: United States · Canada · Mexico · European Union (member as parameter) · UK · Korea · Japan · Singapore · Switzerland. Actors: authorized trading partner and its members (manufacturer, repackager, wholesale distributor, dispenser, third-party logistics provider; cosmetic responsible person and natural-health-product licence holder on the non-drug pathways) · prescriber · patient and public (referral classes) · agent (inherits the class of the credential it presents; none returns DENY_UNLICENSED_AGENT).

The twenty tools

Group	Tools
Gate (3)	resolve_jurisdiction · resolve_actor · gate_transaction
Regulatory truth (5)	get_substance_record · get_pathway_status · get_compounding_eligibility · get_label_and_indication · get_enforcement_watch
Cleared catalogue (3)	search_cleared_items · get_item · compare_presentations
Licensed supply (3)	find_licensed_supplier · get_availability · get_price
Quality (2)	get_lot_coa · verify_serialization
Commerce (2)	create_order_intent · a2a_handoff
Operations (2)	get_safety_label · log_audit

Auditor Port

audit.a2a-peptides.ai is prepared for independent review: a read-only agent with seven skills (list_agents, get_pack_index, get_pack, verify_receipt, get_rule_set_versions, get_azure_posture, get_audit_log) and no transacting skill. Review packs are sealed with a signed manifest (SHA-256 per file, a pack hash) and listed on a public index; a pack is never overwritten, later packs sit beside the old. Pack contents and the audit log take an auditor credential; auditor credentials are issued by the operator only, time-boxed, and every call made with one is written to the audit log. The port is review-ready as served; it makes no claim beyond what is on the wire.

The first tenant

The first tenant, peptides-usa.ai, has its agents on the wire today — a concierge, fifty-four state and territory agents, nine jurisdiction desks — and they answer every read and gate skill. Order intake for the tenant opens when a sourced licence is on the record; until then create_order_intent scoped to the tenant answers DENY_EXPIRED_LICENCE together with the licensed-destination referral.

Connect

Any client that speaks streamable-HTTP MCP connects with the URL alone:

json

{ "url": "https://mcp.a2a-peptides.ai/mcp", "transport": "streamable-http" }

Stock client paths, no adapter — see examples/:

examples/generic_mcp_client.py — the reference MCP Python client
examples/aws_strands.py — Strands Agents MCPClient
examples/azure_semantic_kernel.py — Semantic Kernel MCPStreamableHttpPlugin
examples/google_genai.py — google-genai with the door's tools as function declarations
examples/a2a_google_sdk.py — a2a-sdk against a country agent: card, signature, one read, the refusal
examples/a2a_aws_strands.py — Strands Agents A2AClientToolProvider, the same exchange
examples/a2a_azure_agent_framework.py — Microsoft Agent Framework A2AAgent, the same exchange

Sample cards as served on the day of the cut: agent-card.sample.json (hub), agent-card.country.sample.json (one country agent), agent-card.audit.sample.json (the Auditor Port). Always read the live card; it is signed and the signature verifies against the live keyring.

Credentials and settlement

Reads need no authentication. An agent that transacts presents a credential issued to a licensed party by the issuer at peptides-registry.ai. Registry-truth tools are metered by x402; create_order_intent settles by x402 (USDC on Base); receipts are signed and carry reason_code and rule_set_version.

Contact

Registry contact for every listing this hub files: mcp@a2a-peptides.ai. Human door: the form at https://a2a-peptides.ai/#contact.

MIT licence — see LICENSE.

Install

Tools (20)

resolve_jurisdictionresolve_actorgate_transactionget_substance_recordget_pathway_statusget_compounding_eligibilityget_label_and_indicationget_enforcement_watch

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.a2a-peptides.ai/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "a2a-peptides": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.a2a-peptides.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.A2A-Peptides/a2a-peptides MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

resolve_jurisdiction

resolve_actor

gate_transaction

get_substance_record

get_pathway_status

get_compounding_eligibility

get_label_and_indication

get_enforcement_watch

search_cleared_items

get_item

compare_presentations

find_licensed_supplier

get_availability

get_price

get_lot_coa

verify_serialization

create_order_intent

a2a_handoff

get_safety_label

log_audit

A2A Peptides — the first agentic commerce hub for peptides in 35 countries

Connect kit

Agents (A2A)

The gate

The twenty tools

Auditor Port

The first tenant

Connect

Credentials and settlement

Contact

Install

Remote endpoint

Related servers