Skip to content

Commit 49d6589

Browse files
authored
Merge pull request #28 from agentic-community/fix-issue-27-update-readme-api-documentation
Fix issue #27: Update README API documentation
2 parents 6c5350c + 38962cc commit 49d6589

File tree

1 file changed

+17
-47
lines changed

1 file changed

+17
-47
lines changed

README.md

Lines changed: 17 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -403,38 +403,23 @@ Once connected, your MCP client can:
403403
- Manage server configurations
404404
- Monitor server health and status
405405

406-
### API Usage
407-
408-
#### Adding New MCP Servers
409-
410-
**Option 1 - Via MCP Client (_recommended_):**
411-
Connect any MCP client that supports SSE to the registry and use natural language to register new servers. The registry will guide you through the registration process.
412-
413-
**Option 2 - Direct API Access:**
414-
Use the REST API endpoints directly. First authenticate, then use the registration endpoint:
415-
416-
```bash
417-
# Login to get the session cookie
418-
curl -X POST \
419-
-H "Content-Type: application/x-www-form-urlencoded" \
420-
-d "username=admin&password=$ADMIN_PASSWORD" \
421-
-c cookies.txt \
422-
http://localhost:7860/login
423-
424-
# Register a new MCP server
425-
curl -X POST http://localhost:7860/register \
426-
-H "Content-Type: application/x-www-form-urlencoded" \
427-
-b cookies.txt \
428-
--data-urlencode "name=My New Service" \
429-
--data-urlencode "description=A fantastic new service" \
430-
--data-urlencode "path=/new-service" \
431-
--data-urlencode "proxy_pass_url=http://localhost:8004" \
432-
--data-urlencode "tags=new,experimental" \
433-
--data-urlencode "num_tools=2" \
434-
--data-urlencode "num_stars=0" \
435-
--data-urlencode "is_python=true" \
436-
--data-urlencode "license=MIT"
437-
```
406+
### Adding New MCP Servers to the Registry
407+
408+
**Option 1 - Via MCP Registry UI:**
409+
Click the "Register Server" button on the top right corner of the Registry web interface and follow the instructions. You'll need to provide the following parameters:
410+
411+
- **Server Name**: Display name for the server
412+
- **Path**: Unique URL path prefix for the server (e.g., '/my-service'). Must start with '/'
413+
- **Proxy Pass URL**: The internal or external URL where the MCP server is running (e.g., 'http://localhost:8001')
414+
- **Description**: Description of the server (optional)
415+
- **Tags**: List of tags for categorization (optional)
416+
- **Number of Tools**: Number of tools provided by the server (optional)
417+
- **Number of Stars**: Rating for the server (optional)
418+
- **Is Python**: Whether the server is implemented in Python (optional)
419+
- **License**: License information for the server (optional)
420+
421+
**Option 2 - Via MCP Host:**
422+
_Coming soon_ - Use MCP Host applications such as VSCode-insiders or Cursor to register servers directly through their MCP client interfaces.
438423
439424
#### Integration Example
440425
@@ -466,21 +451,6 @@ async with sse_client(server_url, headers=headers) as (read, write):
466451
```
467452
468453
469-
## API Endpoints (Brief Overview)
470-
471-
See the full API spec [here](docs/registry_api.md).
472-
473-
* `POST /register`: Register a new service (form data).
474-
* `POST /toggle/{service_path}`: Enable/disable a service (form data).
475-
* `POST /edit/{service_path}`: Update service details (form data).
476-
* `GET /api/server_details/{service_path}`: Get full details for a service (JSON).
477-
* `GET /api/tools/{service_path}`: Get the discovered tool list for a service (JSON).
478-
* `POST /api/refresh/{service_path}`: Manually trigger a health check/tool update.
479-
* `GET /login`, `POST /login`, `POST /logout`: Authentication routes.
480-
* `WebSocket /ws/health_status`: Real-time connection for receiving server health status updates.
481-
482-
*(Authentication via session cookie is required for most non-login routes)*
483-
484454
## Roadmap
485455
486456
1. Store the server information in persistent storage.

0 commit comments

Comments
 (0)