Developer

Wisdom MCP

Wisdom gives any MCP-compatible host one readable system for Africa's past, present, and future. It exposes the archive, independent Agenda 2063 data, and long-range futures scenarios through a single remote endpoint, with universal search/fetch tools for ChatGPT and OpenAI API clients plus deeper named tools for hosts that support the full MCP surface.

Remote MCP endpoint

https://wisdom.family/api/mcp

Best first setup path

In ChatGPT, Claude, Cursor, VS Code, or Codex, add a custom remote MCP server named wisdom and paste the endpoint above. Terminal commands are optional, not required.

Wisdom now exposes the OpenAI-compatible search and fetch tools alongside its domain-specific tools, so hosts can start with retrieval and graduate into richer tool calling where supported.

Past
Archive retrieval

Search 561 works across African and diaspora thought, then pull full records with themes, relations, and access links.

Present
Independent data layer

Query 22 Agenda 2063 indicators with coverage, weighting, sources, and goal-level context instead of static report summaries.

Future
Scenario reasoning

Explore 16 futures indicators through Failure, Current Path, and Possible Africa, with clear scenario sources and failure-case logic.

Guidance
Clear on first run

Wisdom ships prompts, resources, and an orientation tool so a host can explain itself clearly, ask one useful question, and be honest about stored text versus external links.

How a good host should use Wisdom

Explain the system

Start with one plain explanation of the archive, the present data layer, and the futures layer.

Ask one useful question

Clarify geography, time horizon, or whether the user wants past, present, or future only when it improves the answer.

Name what is actually stored

If a work has only catalog context, say that. If Wisdom stores an excerpt or internal text, surface it directly.

Installation

In ChatGPT, enable connector developer mode if your plan or workspace requires it, then create a custom MCP connector. Name it Wisdom and paste this server URL:

https://wisdom.family/api/mcp

ChatGPT and OpenAI deep research integrations look for search and fetch. Wisdom exposes both, so users can ask for archive context, Agenda 2063 evidence, or future scenarios without learning tool names.

Tool reference

The current server exposes 15 tools across universal retrieval, orientation, archive, Agenda 2063, and futures.

Universal connectors
ChatGPT
search

Compatibility search across archive, present data, and futures, with an optional layer filter for archive, agenda, or futures.

fetch

Fetches a full item returned by search with text, canonical URL, layer, and metadata for citations.

Orientation
Guide
about_wisdom

Explains what Wisdom is, what the MCP exposes, and how to use it well.

Archive
Past
search_works

Search across the archive catalog and stored context blocks where available.

get_work

Full work record with themes, relations, access links, and internal text status when available.

list_works

Structured browse by region, era, genre, theme, or query.

list_themes

Theme catalog with counts and slugs.

get_theme

All works for a chosen theme slug.

Agenda 2063
Present
get_agenda_overview

Independent overall score, coverage, freshness, and AU comparison context.

get_methodology

Explains the scoring formula, aggregation method, population weighting, and missing-data treatment.

list_agenda_indicators

Browse the 22 live Agenda 2063 indicators.

get_agenda_indicator

Detailed indicator view with progress, weighting, regional averages, and country leaders/laggards.

get_country_profile

Country-level Agenda 2063 profile for an AU member state, including ranks and missing indicators.

Futures
Future
list_future_indicators

Browse the 16 scenario indicators used on the futures page.

get_future_indicator

Current value, 2043 scenarios, sources, and failure-case rationale.

Example prompts

What is Wisdom and what can you do with it here?

Find political philosophy from West Africa after 1960.

Give me the independent Agenda 2063 overview and tell me how much of the framework is actually covered.

Show me the life expectancy indicator and explain the weighted vs simple aggregate.

List the futures indicators in governance and explain the failure scenario logic.

Compare the archive, the present data, and the futures layer for education in Africa.

Contributing

Wisdom is open source under MIT. The work ahead is making the archive deeper, the data cleaner, the futures layer more legible, and the MCP easier to use everywhere.