Allows importing GraphQL specifications and exposing them as tools for agents to query or mutate GraphQL APIs.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@AionMCP Load the Petstore OpenAPI spec and list all pets."
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.
AionMCP is an autonomous Go-based Model Context Protocol (MCP) server that dynamically imports OpenAPI, GraphQL, and AsyncAPI specifications and exposes them as tools to agents. It features self-learning capabilities, context-awareness, and autonomous documentation using Clean/Hexagonal architecture.
Multi-Protocol Support: OpenAPI, GraphQL, and AsyncAPI specifications
Autonomous Learning: Self-improving system that learns from execution patterns
Dynamic Runtime: Hot-reloadable tools without service restart
Clean Architecture: Maintainable, testable, and extensible design
Auto-Documentation: Self-updating documentation and insights
Related MCP server: Swagger MCP
Current Branch: main
Latest Commit: f4f41db
System Health: 99/100 (Excellent)
Active Tools: 3
Commits (7 days): 17
Status updated automatically
aionmcp/
āāā bin/aionmcp-server # Main executable
āāā cmd/server/ # Server entry point
āāā internal/
ā āāā core/ # HTTP/gRPC servers & tool registry
ā āāā selflearn/ # Learning engine & BoltDB storage
ā āāā autodocs/ # Documentation generation
āāā pkg/
ā āāā importer/ # OpenAPI/GraphQL/AsyncAPI parsers
ā āāā agent/ # Agent registration API
ā āāā feedback/ # Feedback collection
āāā vscode-extension/ # VS Code extension
āāā docs/ # Comprehensive documentation
āāā examples/specs/ # Example API specifications
ā āāā petstore.yaml # OpenAPI 3.0 example
ā āāā blog.graphql # GraphQL example
ā āāā user-events.yaml # AsyncAPI example
āāā go.mod # Go dependencies# Clone the repository
git clone https://github.com/kiransth77/aionmcp.git
cd aionmcp
# Build the server
go build -o bin/aionmcp cmd/server/main.go
# Run with default configuration
./bin/aionmcpThe server will start on http://localhost:8080 with learning enabled.
AionMCP follows Clean/Hexagonal Architecture principles:
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
ā Adapters Layer ā
ā āāāāāāāāāāāāāāā āāāāāāāāāāāāāāā āāāāāāāāāāāāāāā ā
ā ā HTTP ā ā gRPC ā ā Plugin ā ā
ā ā Interface ā ā Interface ā ā Interface ā ā
ā āāāāāāāāāāāāāāā āāāāāāāāāāāāāāā āāāāāāāāāāāāāāā ā
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
ā Core Layer ā
ā āāāāāāāāāāāāāāā āāāāāāāāāāāāāāā āāāāāāāāāāāāāāā ā
ā ā Tool ā ā Learning ā ā Auto ā ā
ā ā Registry ā ā Engine ā ā Docs ā ā
ā āāāāāāāāāāāāāāā āāāāāāāāāāāāāāā āāāāāāāāāāāāāāā ā
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
ā Infrastructure Layer ā
ā āāāāāāāāāāāāāāā āāāāāāāāāāāāāāā āāāāāāāāāāāāāāā ā
ā ā Storage ā ā Metrics ā ā Config ā ā
ā ā (BoltDB) ā ā(Prometheus) ā ā (Viper) ā ā
ā āāāāāāāāāāāāāāā āāāāāāāāāāāāāāā āāāāāāāāāāāāāāā ā
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāf4f41db9 fix: clean up TOON package formatting and remove duplicate package declaration (0h ago)
8b97b173 fix: update go-ci.yml to use Go 1.25 to match go.mod requirement (0h ago)
ebeeee28 fix: remove redundant newline in fmt.Println to pass linting (0h ago)
a91eb5f4 feat: add TOON (Token-Oriented Object Notation) for LLM context optimization (0h ago)
bd39bb10 fix: update Dockerfile Go version to 1.25 (0h ago)
š Total insights: 2
Activity updated automatically
Metric | Value | Status |
Success Rate | 97.0% | š¢ Excellent |
Avg Latency | 250.0ms | š” Good |
Total Executions | 42 | š Tracking |
Active Tools | 3 | š§ Running |
Statistics updated in real-time
Go 1.21 or higher
Git
git clone https://github.com/kiransth77/aionmcp.git
cd aionmcp
go mod download
go build -o bin/aionmcp cmd/server/main.go# Start the server
./bin/aionmcp
# With custom configuration
./bin/aionmcp --config config.yaml
# Enable debug logging
AIONMCP_LOG_LEVEL=debug ./bin/aionmcpGET /api/v1/tools - List available tools
POST /api/v1/tools/{tool}/execute - Execute a tool
GET /api/v1/learning/stats - Learning statistics
GET /api/v1/learning/insights - System insights
### Docker
```bash
docker run -p 8080:8080 aionmcp:latestDeploy the binary to your cloud provider, access via public URL.
import "github.com/aionmcp/aionmcp/internal/core"
server := core.NewServer(logger)
server.Start()š Total insights: 2
Activity updated automatically
README last updated: 2025-11-27 22:47:18 AEST
This README is automatically updated with current project status and metrics.
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
Control plane for autonomous software labor. Agents claim objectives over MCP with audit trail.
Self-hosted MCP gateway: turn any API, database or MCP server into AI connectors ā no code.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/kiransth77/aionmcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server