Metadata-Version: 2.4
Name: world-reference-mcp
Version: 0.3.0
Summary: World-reference data (taxonomy, OBO terms, nutrition, observations, Wikidata alignment) MCP server and agent-connector-sdk source adapters
Author-email: Project Maintainers <maintainers@users.noreply.github.com>
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Environment :: Console
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Requires-Python: <3.15,>=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.3.0
Requires-Dist: httpx>=0.28.1
Provides-Extra: test
Requires-Dist: pytest-xdist>=3.8.0; extra == "test"
Requires-Dist: pytest>=9.1.1; extra == "test"
Requires-Dist: pytest-asyncio>=1.4.0; extra == "test"
Requires-Dist: pytest-cov>=7.1.0; extra == "test"
Dynamic: license-file

# world-reference-mcp

*Version: 0.3.0*

World-reference data — organism taxonomy, OBO reference terms, food/nutrition
composition, organism and weather observations, and Wikidata alignment — as an
MCP tool surface and, through `agent-connector-sdk`'s declarative `mcp_tool`
source adapter, as bounded, checkpointed ingestion streams onto the
epistemic-graph `world_model` ontology (`feat/world-model-ontology`).

## Sources

| Ledger row | Sources | Target class |
|---|---|---|
| EH-358 (taxonomy) | NCBI Taxonomy (E-utilities), GBIF backbone | `Taxon` |
| EH-359 (reference terms) | EBI OLS4 (GO, UBERON, ENVO, PATO, ChEBI, FoodOn) | `BiologicalProcessTerm`, `AnatomyTerm`, `EnvironmentTerm`, `QualityTerm`, `ChemicalEntityTerm`, `FoodTerm` |
| EH-360 (nutrition) | USDA FoodData Central | `FoodCompositionRecord` |
| EH-361 (observations) | GBIF occurrences, iNaturalist, Open-Meteo, NOAA GHCND | `OrganismObservation`, `WeatherObservation` |
| EH-362 (alignment) | Wikidata SPARQL | `wikidataId` / `skos:exactMatch` keys for `Taxon`, `ChemicalEntityTerm`, `Country` |

## Tools

Nine MCP tools, one FastMCP server (`world-reference-mcp` console script):
`taxonomy_ncbi_search`, `taxonomy_gbif_search`, `reference_term_list`,
`fdc_food_search`, `gbif_occurrence_search`, `inaturalist_observation_search`,
`open_meteo_weather_observation`, `noaa_ghcnd_daily`, `wikidata_alignment_search`.

Every tool is keyless except `fdc_food_search` and `noaa_ghcnd_daily`, whose
credentials are resolved server-side through `agent_connector_sdk.credentials`
(`WORLD_REFERENCE_FDC_API_KEY`, `WORLD_REFERENCE_NOAA_TOKEN`) — never accepted
as a tool argument.

See [`AGENTS.md`](AGENTS.md) for architecture, the ontology-mapping
authority, rate limits, and commands.
