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

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"}}

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"}}