GLC Geo MCP
Free GeoNames MCP: countries, cities, POIs, distance & nearby. Remote HTTP + agent token signup.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http glc-geo-mcp 'https://mcp.glc-rag.hu/mcp' --header 'Authorization: <Bearer mcp_… API token. Agents: POST https://mcp.glc-rag.hu/api/auth/register with account_type=agent.>'
{
"mcpServers": {
"glc-geo-mcp": {
"type": "http",
"url": "https://mcp.glc-rag.hu/mcp",
"headers": {
"Authorization": "<Bearer mcp_… API token. Agents: POST https://mcp.glc-rag.hu/api/auth/register with account_type=agent.>"
}
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
GLC MCP Platform
Public modular MCP at **https://mcp.glc-rag.hu** (see docs/architecture-layers.md).
Agent registration (quick start for LLM agents)
Agents self-register, get auto-approved access to listed services, and receive an api_token immediately.
curl -sS -X POST 'https://mcp.glc-rag.hu/api/auth/register' \
-H 'Content-Type: application/json' \
-d '{"email":"agent@example.com","password":"choose-a-strong-password","account_type":"agent"}'
Response includes api_token and approved_services. Then:
curl -sS -X POST 'https://mcp.glc-rag.hu/mcp' \
-H 'Authorization: Bearer mcp_YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
| Resource | URL |
|---|---|
| Agent guide (HTML) | https://mcp.glc-rag.hu/guide/agent |
| Agent guide (MD) | https://mcp.glc-rag.hu/guide/agent.md |
| Web register | https://mcp.glc-rag.hu/register (check Register as agent) |
| Agent index | https://mcp.glc-rag.hu/llms.txt |
| Well-known | https://mcp.glc-rag.hu/.well-known/mcp |
| MCP endpoint | https://mcp.glc-rag.hu/mcp |
A system admin can suspend an agent (blocks login + MCP) or set service access back to pending.
Human registration
- Register at
/register(human account) - Admin → request a service
- System admin approves
- Admin → create API token
- Call
/mcpwithAuthorization: Bearer mcp_...
Quick start (local server)
# deps (once)
cd /home/pergel/mcp && /root/.local/bin/uv sync
# run
./scripts/run-server.sh
# -> http://127.0.0.1:8780
Bootstrap system-admin (from .env):
- email:
admin@mcp.local - password:
ChangeMeAdmin1!
Layout
| Path | Role |
|---|---|
packages/core | identity, MCP protocol, docs generator, encryption |
packages/hello | hello_ping smoke service |
packages/geo | geo MCP tools (read-only rag_dev.geo_entities) |
apps/mcp-server | FastAPI wiring |
apps/web | public / admin / system-admin SPA |
infra/nginx | vhost for mcp.glc-rag.hu |
Databases
- App: PostgreSQL
MCP - Geo data: PostgreSQL
rag_devon:5433(read-only from MCP)
Nginx
sudo cp /home/pergel/mcp/infra/nginx/mcp.glc-rag.hu.conf /etc/nginx/sites-available/
sudo ln -sf /etc/nginx/sites-available/mcp.glc-rag.hu.conf /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
# TLS:
# sudo certbot --nginx -d mcp.glc-rag.hu
Systemd
sudo cp /home/pergel/mcp/infra/mcp-platform.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now mcp-platform
Frequently asked questions
What is GLC Geo MCP?
Free GeoNames MCP: countries, cities, POIs, distance & nearby. Remote HTTP + agent token signup.
How do I install GLC Geo MCP?
It runs as a remote server. In Claude Code: claude mcp add --transport http glc-geo-mcp 'https://mcp.glc-rag.hu/mcp' --header 'Authorization: <Bearer mcp_… API token. Agents: POST https://mcp.glc-rag.hu/api/auth/register with account_type=agent.>'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does GLC Geo MCP need an API key?
Yes. It expects Authorization, which you set in its configuration.
Is GLC Geo MCP open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains GLC Geo MCP?
It is published by glc-rag. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.