Global.Church Developer Portal
For App Developers

MCP Integration

The Global.Church API exposes an MCP (Model Context Protocol) endpoint that lets AI assistants interact with the knowledge graph through tool calls. This means you can ask questions in natural language and get structured data back from the graph's 3.2 million triples.

What is MCP?

Model Context Protocol is an open standard that lets AI assistants discover and call external tools. Instead of writing SPARQL queries by hand, an AI assistant can use MCP tools to search organizations, explore people group data, and query the knowledge graph on your behalf.

Endpoint

Code
 
https://api.global.church/v0/mcp

Authentication uses the same API key as all other Global.Church endpoints.

Connecting Claude Desktop

Add the following to your Claude Desktop configuration file (claude_desktop_config.json):

JSONCode
 
{
  "mcpServers": {
    "global-church": {
      "url": "https://api.global.church/v0/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

On macOS, the config file is at:

Code
 
~/Library/Application Support/Claude/claude_desktop_config.json

On Windows:

Code
 
%APPDATA%\Claude\claude_desktop_config.json

After saving the config, restart Claude Desktop. You should see the Global.Church tools available in the tools menu.

Available Tools

The MCP server exposes tools for working with the knowledge graph:

  • Search organizations -- Find organizations by name, country, type, or other criteria.
  • Query the knowledge graph -- Execute SPARQL queries against GraphDB and get structured results.
  • Explore people groups -- Look up people group data including assessment metrics, classification codes, and engagement status.

The tools handle SPARQL generation and result formatting automatically, so you can interact with the graph using natural language.

Example Conversation

Here is what an interaction looks like once MCP is connected:

You: Find all Baptist churches in Texas.

Claude: I will search the knowledge graph for Baptist churches in Texas.

[Calls Global.Church search tool]

Results:

NameCityDenomination
First Baptist Church DallasDallasBaptist
Second Baptist Church HoustonHoustonBaptist
Sagemont ChurchHoustonBaptist
.........

Found 847 Baptist churches in Texas.

You: Which unreached people groups in India have the lowest percentage of Christians?

Claude: Let me query the assessment data for Indian people groups.

[Calls Global.Church SPARQL tool]

The query joins people group identity data with Joshua Project assessment results to find the least-reached groups.

Built-In Chat Interface

MCP is also available through the built-in chat interface at platform.global.church. The platform's MCP chat lets you query the knowledge graph without any local setup -- just sign in and start asking questions.

Getting an API Key

  1. Go to platform.global.church/developer.
  2. Sign in with your Global.Church account.
  3. Create a new API key.
  4. Copy the key and add it to your MCP configuration.

You need the developer platform role to create API keys. If you do not have this role, contact an admin.

Rate Limits

MCP requests go through the same API gateway as direct SPARQL queries. The rate limit is 100 requests per minute per API key.

Next Steps

Last modified on
Contributing Linked DataKnowledge Graph Overview