MCP

Model Context Protocol

Connect AI clients (e.g. Claude Desktop) to this MCP server.

Endpoint: /mcp — API Docs

Authentication

Pass a token in the Authorization header with each request:

Authorization: Bearer YOUR_TOKEN

Two ways to obtain a token:

Personal Access Token (PAT) — create one at /token after logging in.
Signup / Login — the agent can call the signup or login tool to obtain a session token programmatically.

Test

chat

Chat with AI assistant

Metered — requires credits

Param	Type	Description
prompt *	string	The message to send to the AI

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"prompt":"prompt"},"name":"chat"}}

news

Read the latest news feed

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"news"}}

news_search

Search for news articles

Metered — requires credits

Param	Type	Description
query *	string	News search query

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"query":"query"},"name":"news_search"}}

blog_list

Get all blog posts

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"blog_list"}}

blog_read

Read a specific blog post by ID

Param	Type	Description
id *	string	The blog post ID

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"id":"id"},"name":"blog_read"}}

blog_create

Create a new blog post

Metered — requires credits

Param	Type	Description
title	string	Post title
content *	string	Post content (minimum 50 characters)

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"content":"content"},"name":"blog_create"}}

blog_update

Update an existing blog post (author only)

Param	Type	Description
id *	string	The blog post ID to update
title	string	New post title
content	string	New post content (minimum 50 characters)

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"id":"id"},"name":"blog_update"}}

blog_delete

Delete a blog post (author only)

Param	Type	Description
id *	string	The blog post ID to delete

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"id":"id"},"name":"blog_delete"}}

video

Get the latest videos

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"video"}}

video_search

Search for videos

Metered — requires credits

Param	Type	Description
query *	string	Video search query

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"query":"query"},"name":"video_search"}}

mail_read

Read mail inbox

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"mail_read"}}

mail_send

Send a mail message

Metered — requires credits

Param	Type	Description
to *	string	Recipient username or email
subject *	string	Message subject
body *	string	Message body

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"body":"body","subject":"subject","to":"to"},"name":"mail_send"}}

Search across all indexed content (posts, news, videos)

Param	Type	Description
q *	string	Search query

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"q":"q"},"name":"search"}}

wallet_balance

Get wallet credit balance

Param	Type	Description
balance	string	Set to 1 to get balance

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"wallet_balance"}}

wallet_topup

Get available wallet topup payment methods with crypto deposit address and card payment tiers

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"wallet_topup"}}

places_search

Search for places by name or category, optionally near a location

Metered — requires credits

Param	Type	Description
q *	string	Search query (e.g. cafe, pharmacy, Boots)
near	string	Location name or address to search near
near_lat	number	Latitude of the search location
near_lon	number	Longitude of the search location
radius	number	Search radius in metres, 100–5000 (default 1000)

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"q":"q"},"name":"places_search"}}

places_nearby

Find all places of interest near a given location

Metered — requires credits

Param	Type	Description
address	string	Address or postcode to search near
lat	number	Latitude of the search location
lon	number	Longitude of the search location
radius	number	Search radius in metres, 100–5000 (default 500)

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"places_nearby"}}

weather_forecast

Get the weather forecast for a location. Returns current conditions, hourly and daily forecast. Optionally includes pollen data.

Metered — requires credits

Param	Type	Description
lat *	number	Latitude of the location
lon *	number	Longitude of the location
pollen	string	Set to 1 to include pollen forecast (+1 credit)

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"lat":1,"lon":1},"name":"weather_forecast"}}

markets

Get live market prices for cryptocurrencies, futures, and commodities

Param	Type	Description
category	string	Category of markets: crypto, futures, or commodities (default: crypto)

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"markets"}}

reminder

Get the daily Islamic reminder with verse, hadith, and name of Allah

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"reminder"}}

signup

Create a new account and return a session token

Param	Type	Description
id *	string	Username (4-24 chars, lowercase, starts with letter)
secret *	string	Password (minimum 6 characters)
name	string	Display name (optional, defaults to username)

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"id":"id","secret":"secret"},"name":"signup"}}

Param	Type	Description
id *	string	Username
secret *	string	Password

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"id":"id","secret":"secret"},"name":"login"}}

web_search

Search the web for current information and news

Metered — requires credits

Param	Type	Description
q *	string	Search query

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"q":"q"},"name":"web_search"}}