scholarx — Concept Overview¶
Category: Intelligence | Ecosystem Role: MCP Server + A2A Agent Built on
agent-utilities— the unified AGI Harness.
Description¶
Universal Research Paper API — single entry point for arXiv, PMC, bioRxiv, medRxiv, PsyArXiv, OSF, and Semantic Scholar
Enterprise Readiness¶
All agents in the ecosystem inherit enterprise-grade infrastructure from agent-utilities:
| Feature | Status | Source |
|---|---|---|
| JWT/OIDC Authentication | ✅ Built-in | agent-utilities[auth] — Authlib JWKS + API key middleware |
| OpenTelemetry Instrumentation | ✅ Built-in | agent-utilities[logfire] — OTLP export, FastAPI auto-instrumentation |
| HashiCorp Vault Integration | ✅ Built-in | agent-utilities[vault] — secret://, env://, vault:// URI schemes |
| Audit Logging | ✅ Built-in | Append-only compliance trail with 30+ action types (CONCEPT:AU-OS.governance.wasm-micro-agent-sandbox) |
| Token Usage Analytics | ✅ Built-in | 4-bucket tracking with budget alerting (CONCEPT:AU-OS.governance.wasm-micro-agent-sandbox) |
| Prompt Injection Defense | ✅ Built-in | 25+ pattern scanner + jailbreak taxonomy (CONCEPT:AU-OS.config.secrets-authentication) |
| Guardrail Engine | ✅ Built-in | Input/output interception with block/redact/warn (CONCEPT:AU-OS.governance.reactive-multi-axis-budget) |
| Action Execution Pipeline | ✅ Built-in | Token, cost, duration, and node transition limits Dry-run / commit / rollback phases (CONCEPT:AU-ORCH.adapter.kg-graph-materialization) |
| Resource Scheduling | ✅ Built-in | Priority queuing + preemption limits (CONCEPT:AU-OS.state.cognitive-scheduler-preemption) |
| Session Concurrency | ✅ Built-in | Enqueue/reject/interrupt/rollback (CONCEPT:AU-OS.governance.reactive-multi-axis-budget) |
Concept Registry¶
This project implements or inherits the following ecosystem concepts:
| Concept ID | Description | Source |
|---|---|---|
| ECO-4.1 | MCP & Universal Skills | agent-utilities (inherited) |
| KG-2.11 | Research Intelligence Pipeline | agent-utilities (inherited) |
| KG-2.12 | KG Source Resolver | agent-utilities (inherited) |
📖 Full Registry: See
agent-utilities/docs/overview.mdfor the complete 5-Pillar concept index.
Architecture¶
This project follows the standardized agent-package pattern:
scholarx/
├── scholarx/ # Source code
│ ├── __init__.py
│ ├── agent_server.py # Entry point (create_graph_agent_server)
│ ├── api_client.py # REST/GraphQL API wrapper
│ └── mcp_server.py # FastMCP tool definitions
├── tests/ # Test suite
├── docs/ # Documentation
├── pyproject.toml # Package metadata
├── mcp_config.json # MCP server configuration
├── main_agent.json # Agent identity & system prompt
└── Dockerfile # Container deployment
MCP Configuration¶
stdio Mode¶
{
"mcpServers": {
"scholarx": {
"command": "uv",
"args": ["run", "--with", "scholarx", "scholarx-mcp"],
"env": {}
}
}
}