Australian Facts MCP
Documentation
Australian Facts is a read-only MCP server. It answers questions with facts about Australia's geography, wildlife, history, culture, science and sport.
Endpoints
| URL | Authentication |
|---|---|
https://australian-facts-mcp.tobin-south.workers.dev/mcp | OAuth 2.1 authorization code flow with PKCE. Uses a pre-registered client (client ID and secret issued by the server operator); each user signs in and approves access. |
https://australian-facts-mcp.tobin-south.workers.dev/mcp-key | Static API key sent as Authorization: Bearer <key>. |
Both endpoints use the Streamable HTTP transport and support MCP protocol versions from 2025-03-26 onwards.
Connect from Claude
- Add a custom connector with the URL
https://australian-facts-mcp.tobin-south.workers.dev/mcp. - Under Advanced settings, enter the OAuth client ID and client secret you were given.
- Click Connect. A sign-in page opens: sign in and click Sign in & approve.
Tools
| Tool | Description |
|---|---|
random_fact | A random fact, optionally limited to one category. In apps that support MCP Apps it shows an interactive fact card. |
search_facts | Facts containing every word of query (up to limit, default 10). |
list_categories | The categories and how many facts each has. |
Categories: geography, wildlife, history, culture, science, sport. All tools are read-only.
OAuth details
- Protected resource metadata:
/.well-known/oauth-protected-resource/mcp - Authorization server metadata:
/.well-known/oauth-authorization-server - Grants:
authorization_code(PKCE S256 required) andrefresh_token. No dynamic client registration. - Scope:
facts:read. Access tokens last 1 hour; refresh tokens 30 days. - Redirect URIs: Claude's callback (
https://claude.ai/api/mcp/auth_callback,https://claude.com/api/mcp/auth_callback) and loopback addresses for local clients.
Example (API key)
curl https://australian-facts-mcp.tobin-south.workers.dev/mcp-key \
-H "Authorization: Bearer $MCP_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "MCP-Protocol-Version: 2025-06-18" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'