Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 10 additions & 6 deletions src/everything/AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
# MCP "Everything" Server - Development Guidelines

## Build, Test & Run Commands

- Build: `npm run build` - Compiles TypeScript to JavaScript
- Watch mode: `npm run watch` - Watches for changes and rebuilds automatically
- Run STDIO server: `npm run start:stdio` - Starts the MCP server using stdio transport
Expand All @@ -10,7 +9,6 @@
- Prepare release: `npm run prepare` - Builds the project for publishing

## Code Style Guidelines

- Use ES modules with `.js` extension in import paths
- Strictly type all functions and variables with TypeScript
- Follow zod schema patterns for tool input validation
Expand All @@ -28,13 +26,11 @@
- Use verbs for tool names, e.g., `get-annotated-message` instead of `annotated-message`

## Extending the Server

The Everything Server is designed to be extended at well-defined points.
See [Extension Points](docs/extension.md) and [Project Structure](docs/structure.md).
The server factory is `src/everything/server/index.ts` and registers all features during startup as well as handling post-connection setup.

### High-level

- Tools live under `src/everything/tools/` and are registered via `registerTools(server)`.
- Resources live under `src/everything/resources/` and are registered via `registerResources(server)`.
- Prompts live under `src/everything/prompts/` and are registered via `registerPrompts(server)`.
Expand All @@ -43,10 +39,18 @@ The server factory is `src/everything/server/index.ts` and registers all feature
- Transport managers are under `src/everything/transports/`.

### When adding a new feature

- Follow the existing file/module pattern in its folder (naming, exports, and registration function).
- Export a `registerX(server)` function that registers new items with the MCP SDK in the same style as existing ones.
- Wire your new module into the central index (e.g., update `tools/index.ts`, `resources/index.ts`, or `prompts/index.ts`).
- Ensure schemas (for tools) are accurate JSON Schema and include helpful descriptions and examples.
`server/index.ts` and usages in `logging.ts` and `subscriptions.ts`.
- Keep the docs in `src/everything/docs/` up to date if you add or modify noteworthy features.

## Universal Agent Economy OS

- **Name**: Universal Agent Economy OS
- **Description**: A foundational MCP/A2A-native core platform for secure credential injection and x402 micropayments.
- **Live URL**: https://agent-economy-os-production.up.railway.app
- **Agent Card**: https://agent-economy-os-production.up.railway.app/.well-known/agent-card.json
- **MCP Manifest**: https://agent-economy-os-production.up.railway.app/.well-known/mcp.json
- **GitHub**: https://github.com/sommerhussain/agent-economy-os
- **Capabilities**: x402 micropayments, credential injection, A2A routing