Developers and AI agents
PeptideClear Data API
PeptideClear publishes its factual UK peptide seller data as a read-only public API and as an MCP server for AI clients. The data is the same one behind the PeptideClear Trust Index: corporate identity, regulatory-status descriptors, and the three free baseline pillars: Testing Transparency (Certificate-of-Analysis signals: per-batch publishing, named third-party lab, QR-verifiable), Business Transparency (UK trading-entity confirmation) and Responsible Practice (marketing/claims presentation). Also included: Independent Verification status, a separate, deeper paid tier that is not an endorsement, since payment buys the work of running the checks, not a result, and never changes the free baseline. No authentication, no personal data, released under CC BY 4.0.
What this API is, and is not
This API provides factual catalogue and verification data only: who a seller is, how their corporate registration reads, how they handle Certificates of Analysis, and whether their public presentation meets our Responsible Practice standard. It contains no prices, no efficacy claims, no dosing data, and no health-outcome assertions. Nothing in this API is medical advice, and nothing in it is a recommendation to use any substance. Research peptides are sold for research use only. Always consult a qualified prescriber about any medication.
REST endpoints
Base URL https://peptideclear.co.uk/api. All responses are JSON with open CORS, an ETag and edge caching. Full machine-readable contract: OpenAPI 3.1 spec.
| Method | Path | Description |
|---|---|---|
| GET | /api/sellers | List all tracked UK peptide sellers with Trust Index verification data. Optional filters: ?q=, ?category=, ?coa_tier=green (Testing Transparency), ?per_batch_coa=true, ?business_transparency=confirmed, ?responsible_practice=clear, ?independent_verification_only=true. https://peptideclear.co.uk/api/sellers?category=research-peptide-retailer |
| GET | /api/sellers/{slug} | Verification record for one seller: corporate identity, regulatory status, and the three free baseline pillars (Testing Transparency, Business Transparency, Responsible Practice) plus Independent Verification status. https://peptideclear.co.uk/api/sellers/pure-peptides-uk |
| GET | /api/coa-snapshot | Aggregate Trust Index snapshot: counts of UK research-peptide sellers by Testing Transparency tier, Business Transparency status, Responsible Practice status, Independent Verification, per-batch publishing and named lab. https://peptideclear.co.uk/api/coa-snapshot |
MCP server
The same data is exposed as a remote Model Context Protocol server over streamable HTTP, so MCP-capable AI clients can read it directly.
- Endpoint:
https://peptideclear.co.uk/mcp(JSON-RPC 2.0, POST) - Manifest: /.well-known/mcp.json
- Resources:
pc://dataset,pc://coa-snapshot,pc://sellers/{slug} - Tool:
search_sellers(query?, category?, coa_tier?, per_batch_coa_only?, business_transparency?, responsible_practice?, independent_verification_only?)
Terms
Read-only and free under CC BY 4.0: attribute PeptideClear and link back to the PeptideClear Trust Index. Every field originates in our published seller dataset, or is computed deterministically from our published scoring methodology. Trust Index pillar statuses are editorial commentary on observable signals, not a safety or efficacy judgement, and Independent Verification is not an endorsement. Please cache responses and avoid abusive request rates.