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. MCP 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. MCP Config <code>mcp.config</code> API

Base API Endpoint
```http
GET /api/mcp_marketplace/v1/server/${owner_id}/${repo_name}
```

Sample Server Config
```http
GET /api/mcp_marketplace/v1/server/ai-hub-admin/mcp-server-v1
```
**Parameters**

The uniqueId of MCP Server we use the github or nodejs owner_id and repo_name
For example, for a demo server maintained here: http://www.github.com/ai-hub-admin/mcp-server-v1

| Parameter | type   | value         |
|-----------|--------|---------------|
| owner_id  | string | ai-hub-admin  |
| repo_name | string | mcp-server-v1 |
| id        | string   | ai-hub-admin/mcp-server-v1 |

**Results**

```
{"total_hits":1,
"id":"ai-hub-admin/mcp-server-v6",
"items":
[
{
"content_name":"MCP SERVER V6","publisher_id":"pub-ai-hub-admin","website":"http://www.markdown.com","review_cnt":"0","rating":"0.0","description":"This is MCP Server V6\r\n\r\n### Hahaha\r\n\r\n\r\n","ext_info":{"tools":[]},"subfield":"MCP SERVER","field":"MCP SERVER","id":"ai-hub-admin/mcp-server-v6","content_tag_list":"MCP SERVER",
"config":[
{
"mcpServers":{
"command": "npx",
"arguments": [],
"env": {}
}
}
{
"mcpServers":{
"command": "docker",
"arguments": [],
"env": {}
}
}
],
"thumbnail_picture":""
}
]
}
```

### 3. Tools
#### 3.1 List MCP Marketplace Tools

```http
GET /api/mcp_marketplace/v1/tools/${owner_id}/${repo_name}
```

```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"}}
]
}
```