get_search

Search for coins, categories, markets, NFTs, and exchanges on CoinGecko. Use the jq_filter parameter to optimize response size and performance by extracting specific data fields as needed.

Instructions

When using this tool, always use the jq_filter parameter to reduce the response size and improve performance.

Only omit if you're sure you don't need the data.

This endpoint allows you to search for coins, categories and markets listed on CoinGecko

Response Schema

{
  type: 'object',
  properties: {
    categories: {
      type: 'array',
      items: {
        type: 'object',
        properties: {
          id: {
            type: 'string',
            description: 'category ID'
          },
          name: {
            type: 'string',
            description: 'category name'
          }
        }
      }
    },
    coins: {
      type: 'array',
      items: {
        type: 'object',
        properties: {
          id: {
            type: 'string',
            description: 'coin ID'
          },
          api_symbol: {
            type: 'string',
            description: 'coin api symbol'
          },
          large: {
            type: 'string',
            description: 'coin large image url'
          },
          market_cap_rank: {
            type: 'number',
            description: 'coin market cap rank'
          },
          name: {
            type: 'string',
            description: 'coin name'
          },
          symbol: {
            type: 'string',
            description: 'coin symbol'
          },
          thumb: {
            type: 'string',
            description: 'coin thumb image url'
          }
        }
      }
    },
    exchanges: {
      type: 'array',
      items: {
        type: 'object',
        properties: {
          id: {
            type: 'string',
            description: 'exchange ID'
          },
          large: {
            type: 'string',
            description: 'exchange large image url'
          },
          market_type: {
            type: 'string',
            description: 'exchange market type'
          },
          name: {
            type: 'string',
            description: 'exchange name'
          },
          thumb: {
            type: 'string',
            description: 'exchange thumb image url'
          }
        }
      }
    },
    icos: {
      type: 'array',
      items: {
        type: 'string'
      }
    },
    nfts: {
      type: 'array',
      items: {
        type: 'object',
        properties: {
          id: {
            type: 'string',
            description: 'NFT collection ID'
          },
          name: {
            type: 'string',
            description: 'NFT name'
          },
          symbol: {
            type: 'string',
            description: 'NFT collection symbol'
          },
          thumb: {
            type: 'string',
            description: 'NFT collection thumb image url'
          }
        }
      }
    }
  }
}

Input Schema

Name	Required	Description	Default
`jq_filter`	No	A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available. For example: to include only the `name` field in every object of a results array, you can provide ".results[].name". For more information, see the [jq documentation](https://jqlang.org/manual/).
`query`	Yes	search query

Input Schema (JSON Schema)

{
  "properties": {
    "jq_filter": {
      "description": "A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide \".results[].name\".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).",
      "title": "jq Filter",
      "type": "string"
    },
    "query": {
      "description": "search query",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

CoinGecko MCP Server

get_search

Instructions

Response Schema

Input Schema

Input Schema (JSON Schema)

Other Tools from CoinGecko MCP Server

Related Tools

MCP directory API