Skip to main content
Glama
alumnx-ai-labs

Alumnx MCP Server

Official
by alumnx-ai-labs
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

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)

Related MCP server: Government Scheme MCP Server

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

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/alumnx-ai-labs/agrigpt-backend-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server