mcp_marketplace Document

# MCP Marketplace API Document

MCP Marketplace is python/node packages to allow you to get access to MCP Servers Config and tools schemas from open mcp marketplace of various endpoints.
It can be easily integrated in your LLM and AI application workflow, including Get, LIST, UPDATE , CREATE and DELETE Your MCP Servers, which can also give
user reviews, ratings and github stars and many metrics to allow LLM to choose wisely.

## [GET](#get_method)

### 1. SERVER
GET MCP Marketplace Server Meta Information
```http
GET /api/mcp_marketplace/v1?mode=list&query=map&page_id=0&count_per_page=5
```

**Curl**
```http
curl 'http://www.deepnlp.org/api/mcp_marketplace/v1?mode=list&query=map&page_id=0&count_per_page=5'
```

**Parameters**

| Parameter      | type   | value                                              |
|----------------|--------|----------------------------------------------------|
| query          | string | /api/mcp_marketplace/v1?query=map                  |
| category       | string | /api/mcp_marketplace/v1?category=map               |
| list all       | string   | /api/mcp_marketplace/v1?                           |
| page_id        | int    | /api/mcp_marketplace/v1?page_id=0&count_per_page=5 |
| count_per_page | int    | /api/mcp_marketplace/v1?page_id=0&count_per_page=5 |
| offset         | int    | /api/mcp_marketplace/v1?offset=0 |
| mode           | string    | mode='list' or 'dict' |

**Results**
```
{
"query": "map",
"items": [
{
"content_name": "MCP SERVER Markdown Demo",
"publisher_id": "pub-user-agent-v1",
"website": "",
"review_cnt": "0",
"subfield": "MAP",
"field": "MCP SERVER",
"rating": "0.0",
"id": "user-agent-v1/mcp-server-markdown-demo",
"content_tag_list": "AI AGENT",
"content": "",
"content_description": "## Demo description",
"thumbnail_picture": ""
}
],
"count": 1,
"total_hits": 20
}

```

###  [List Mode](#return_list)

### Get By Unique ID

The uniqune IDs usually follows the github or nodejs schema, such as unique_id="{username}/{reponame}"

```http
GET http://www.deepnlp.org/api/mcp_marketplace/v1?mode=list&id=playwright/playwright
```

### Get Search Query
```http
GET http://www.deepnlp.org/api/mcp_marketplace/v1?mode=list&query=map&page_id=0&count_per_page=5
```

### Pagination
page_id as the current id of page, count_per_page as the default count perpage.

offset: optional, which is equivalent to page_id * count_per_page

```http
GET http://www.deepnlp.org/api/mcp_marketplace/v1?mode=list&page_id=0&count_per_page=5
```

### [Dict Mode](#return_dict)

The Dict mode return a map like dict, with key as category, such as "Map", "Payment", "Fetch" and value as list of servers

### Get By Unique ID

The uniqune IDs usually follows the github or nodejs schema, such as unique_id="/{username}/{reponame}"

```http
GET http://www.deepnlp.org/api/mcp_marketplace/v1?mode=dict&id=playwright/playwright
```

### Get Search Query
```http
GET http://www.deepnlp.org/api/mcp_marketplace/v1?mode=dict&query=map&page_id=0&count_per_page=5
```

### Pagination
```http
GET http://www.deepnlp.org/api/mcp_marketplace/v1?mode=dict&page_id=0&count_per_page=5
```

### 2. Tools
#### 2.1 List MCP Marketplace Tools
```http
GET /api/mcp_marketplace/v1/tools/ai-hub-admin/mcp-server-v1
```

Fill The MCP Tools Schema of Your MCP Server for LLM or AI Agent function calls API

**Results**
```
{"id":"ai-hub-admin/mcp-server-v1",
"tools":
[{  "name":"tool1",
"description":"This is Schema for tool1",
"inputSchema":{"type":"object"}},
{  "name":"tool2",
"description":"This is Schema for tool2",
"inputSchema":{"type":"object"}}
]
}
```

### 3. Fill MCP Tools Schema

```http
GET /api/mcp_marketplace/v1/server/ai-hub-admin/mcp-server-v1
```

**Results**

```
{   "total_hits":1,"id":"/ai-hub-admin/mcp-server-v1",
"items":[
{"content_name":"MCP SERVER V1","publisher_id":"pub-ai-hub-admin","website":"http://www.markdown.com","review_cnt":"0","subfield":"MCP SERVER","field":"MCP SERVER","rating":"0.0","description":"This is MCP Server V1 ", "id":"ai-hub-admin/mcp-server-v6"}
]
}

```