How do I use Alumnx MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Alumnx MCP Server what are the symptoms of powdery mildew on grapes?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Alumnx MCP Server

A Model Context Protocol (MCP) server for agricultural intelligence, providing tools for pest/disease lookup, government scheme discovery, and SME knowledge retrieval via semantic search.

Features

Pests & Diseases — RAG-powered lookup for crop pest and disease information
Government Schemes — RAG-powered search for agriculture-related government schemes by type and state
SME Divesh — Semantic search over a Pinecone knowledge base (SME-Divesh namespace)
MCP + REST — Dual interface: MCP protocol (via FastMCP) and plain REST (/callTool)

Requirements

Python 3.9+
Dependencies (install via pip install -r requirements.txt):

fastmcp
pinecone
sentence-transformers
python-dotenv
uvicorn
httpx
fastapi

Environment Variables

Create a .env file in the project root with the following variables:

Variable	Required	Description
`PESTS_DISEASES_RAG_URL`	✅	Base URL of the Pests & Diseases RAG service
`GOVT_SCHEMES_RAG_URL`	✅	Base URL of the Government Schemes RAG service
`PINECONE_API_KEY`	✅	API key for Pinecone
`PINECONE_INDEX`	✅	Name of the Pinecone index to query
`RAG_TIMEOUT`	❌	HTTP timeout in seconds for RAG calls (default: `30`)

Example .env:

PESTS_DISEASES_RAG_URL= ___URL__
GOVT_SCHEMES_RAG_URL= __URL__
PINECONE_API_KEY=your-pinecone-api-key
PINECONE_INDEX=your-index-name
RAG_TIMEOUT=30

Running the Server

python alumnx_mcp_server.py

The server starts on port 9000 by default.

Endpoint	Description
`/mcp`	MCP protocol endpoint (FastMCP)
`/callTool`	REST tool call endpoint
`/list-tools`	Lists all available tools
`/health`	Health check

MCP Tools

`pests_and_diseases`

Query the RAG system for information about pests and diseases affecting crops.

Parameter	Type	Required	Default	Description
`pest_name`	string	✅	—	Name of the pest or disease
`crop`	string	❌	`"General"`	Crop affected by the pest or disease

Example response:

{
  "status": "success",
  "information": "...",
  "sources": ["..."]
}

`govt_schemes`

Query the RAG system for government schemes related to agriculture.

Parameter	Type	Required	Default	Description
`scheme_type`	string	✅	—	Type or topic of the scheme
`state`	string	❌	`"All India"`	State for which to retrieve schemes

Example response:

{
  "status": "success",
  "information": "...",
  "sources": ["..."]
}

`sme_divesh`

Semantic search over the SME-Divesh Pinecone namespace using all-MiniLM-L6-v2 embeddings.

Parameter	Type	Required	Default	Description
`query`	string	✅	—	The search query
`top_k`	integer	❌	`5`	Number of top results to return

Example response:

{
  "status": "success",
  "query": "crop irrigation techniques",
  "results": [
    {
      "score": 0.91,
      "text": "...",
      "source": "...",
      "chunk_index": 2
    }
  ]
}

REST API Usage

All tools are also callable via the /callTool POST endpoint:

curl -X POST http://localhost:9000/callTool \
  -H "Content-Type: application/json" \
  -d '{
    "name": "pests_and_diseases",
    "arguments": {
      "pest_name": "aphids",
      "crop": "wheat"
    }
  }'

Architecture

┌─────────────────────────────────────────┐
│            Alumnx MCP Server            │
│                                         │
│  FastAPI App                            │
│  ├── /mcp          ← FastMCP (MCP)      │
│  ├── /callTool     ← REST interface     │
│  ├── /list-tools   ← Tool discovery     │
│  └── /health       ← Health check       │
│                                         │
│  Tools                                  │
│  ├── pests_and_diseases → RAG HTTP call │
│  ├── govt_schemes       → RAG HTTP call │
│  └── sme_divesh         → Pinecone      │
└─────────────────────────────────────────┘

This server cannot be installed

A

license - permissive license

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Alumnx MCP Server

Alumnx MCP Server

Features

Requirements

Environment Variables

Running the Server

MCP Tools

`pests_and_diseases`

`govt_schemes`

`sme_divesh`

REST API Usage

Architecture

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API