eff-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| OPENAI_MODEL | No | Model name (default: gpt-5.4-mini). | gpt-5.4-mini |
| SUPABASE_KEY | No | Supabase anon key (required if EFF_RETRIEVAL_PROVIDER=supabase). | |
| SUPABASE_RPC | No | Supabase RPC function name (default: match_documents). | match_documents |
| SUPABASE_URL | No | Supabase project URL (required if EFF_RETRIEVAL_PROVIDER=supabase). | |
| OPENAI_API_KEY | Yes | OpenAI API key (required, no default). | |
| EFF_RETRIEVAL_K | No | Number of chunks per query (default: 5). | 5 |
| OPENAI_BASE_URL | No | OpenAI-compatible base URL (Azure, local, etc.). Optional. | |
| EFF_AUDIT_LOG_PATH | No | Path for audit log file (JSONL). Optional, disabled if unset. | |
| EFF_RETRIEVAL_PROVIDER | No | Retrieval provider (none or supabase, default: none). | none |
| OPENAI_EMBEDDING_MODEL | No | Embedding model (default: text-embedding-3-small). | text-embedding-3-small |
| EFF_EXTRA_DIMENSIONS_PATH | No | Path to JSON file with custom dimensions definitions. Optional. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ethics_filterC | Run the Ethics Filter Framework on a user story. |
| list_eff_resourcesA | List available EFF MCP resources and their descriptions. |
| list_bib_resourcesA | List all BibTeX entries as MCP resources with minimal metadata. |
| get_skill_instructionsA | Return the EFF skill instructions and workflow (eff://skill). |
| get_dimensions_rubricA | Return the EFF rubric and dimension definitions (eff://dimensions). |
| get_examplesA | Return the EFF worked examples and templates (eff://examples). |
| search_citationsA | Search BibTeX entries for a query string in any field. Returns minimal metadata. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| get_dimensions | Serve the EFF dimensions.json as an MCP resource. |
| get_skill | Serve the EFF SKILL.md as an MCP resource. |
| get_examples_resource | Serve the EFF examples.md as an MCP resource. |
TDQS
Scored across 7 tools
Each tool has a clear, distinct purpose: one runs the filter, three retrieve specific EFF resources, two manage BibTeX listings, and one searches citations. No two tools overlap in functionality.
Most tool names follow a verb_noun pattern (list_eff_resources, get_skill_instructions, search_citations), but 'ethics_filter' deviates by omitting a verb prefix, making it slightly inconsistent.
Seven tools is a reasonable number for a server that provides both an ethics filter framework (with supporting resources) and a citation search utility. It is neither sparse nor bloated.
The EFF workflow is fully covered: run the filter, fetch instructions, rubric, and examples. The BibTeX side lacks explicit get-by-id or management operations, but list and search are sufficient for read-only citation lookup.