Developer & AI access

One corpus, two stable interfaces

Use hierarchical REST endpoints for applications, or let an AI client discover and invoke ten bounded read-only tools through the same-origin Streamable HTTP MCP endpoint.

REST API v1

Canonical endpoints return a consistent data / meta / links envelope. Legacy flat paths remain aliases.

GET/api/v1/system/stats
GET/api/v1/catalog/peptides
GET/api/v1/catalog/papers
GET/api/v1/evidence/audit-summary
GET/api/v1/evaluation/development-examples
GET/api/v1/schema/database

Open OpenAPI 3.1 schema →

Streamable HTTP MCP

Stateless endpoint at /api/mcp, supporting modern 2026-07-28 discovery and legacy 2025-11-25 initialization. No authentication or write tools.

{"mcpServers":{"amp-evidence-atlas":{"url":"https://amp.xueguo.us/api/mcp"}}}

Server descriptor

curl -X POST https://amp.xueguo.us/api/mcp \ -H 'Content-Type: application/json' \ -H 'Accept: application/json, text/event-stream' \ -H 'MCP-Protocol-Version: 2026-07-28' \ -H 'Mcp-Method: tools/list' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

atlas.describe

Describe AMP Evidence Atlas

Return release scope, aggregate statistics and the normalized public database hierarchy.

atlas.search

Search the public-safe catalog

Search peptide names, displayed sequence variants, paper IDs and DOIs.

atlas.list_peptides

List peptide summaries

Browse and filter rights-safe derived peptide summaries with bounded pagination.

atlas.get_peptide

Get one peptide

Return the exact public-safe summary for a peptide name.

atlas.list_papers

List paper summaries

Browse paper identifiers and project-created review/count metadata.

atlas.get_paper

Get one paper

Return the exact public-safe summary for a paper ID.

atlas.get_audit_summary

Get aggregate audit outcomes

Return database/status and difference-category aggregates, optionally filtered.

atlas.list_development_examples

List public development examples

Return bounded prompt-only development examples. Gold answers, scoring keys and exact evidence references are unavailable.

atlas.get_rights_policy

Get rights policy

Return source-rights decisions, excluded components and open permission follow-up.

atlas.get_database_schema

Get public database schema

Return layers, entities, views and relationships of the normalized rights-safe read model.

Live API console

Run a rights-safe API request.

Live MCP tool call

Call a modern stateless MCP tool.
Normalized database

Six layers, one rights-safe read model.

System provenance, source governance, discovery catalogs, evidence aggregates, prompt-only development examples and stable API views are separated so public clients cannot accidentally cross into restricted raw records.

01

system

Release identity, provenance checksum and scope flags.

system_release
02

governance

Per-source redistribution decisions and terms links.

governance_source_rights
03

catalog

Derived paper and peptide discovery indexes.

catalog_papercatalog_peptidecatalog_peptide_sequencecatalog_peptide_endpointcatalog_peptide_target_examplecatalog_peptide_evidence_tiercatalog_peptide_paper
04

evidence

Aggregate audit outcomes; no row-level source comparison.

evidence_audit_aggregateevidence_difference_category
05

evaluation

Project-authored prompt-only development examples; no gold answers.

evaluation_development_example
06

api

Stable read views used by API and AI/MCP clients.

api_peptide_summaryapi_paper_summary