Agentic Platform
Documentation API reference Tools Skills

Tools

Google Knowledge Graph

google_knowledge_graph MCP Google

Search Google Knowledge Graph for entities about people, places, and things.

Search the Google Knowledge Graph to find information about millions of real-world entities and their relationships, like people, places, organizations, and things.

Playground

Your organization, project and token stay in this browser's local storage and are sent straight to the API — this page never sees them.

POST
item
query required The entity or topic to search for in the Knowledge Graph
config
limit Maximum number of entities to return (1-50)
types Filter results by entity types (e.g., Person, Place, Organization)
languages Filter results by language codes (e.g., en, fr, es)

Billing

Fixed cost per item requested, plus one entity lookup. The lookup is rate-limited across all Botify customers, which is what it is priced for rather than the cost of the call.

These usage SKUs can be charged on a call.

SKU Credits Description
Tool call 1 per request Charged once per successful item, on top of any usage below.
Entity lookup 5 per lookup Looks an entity up in a public knowledge graph. The lookup is rate-limited across every Botify customer, so it is priced to stop one caller exhausting the shared ceiling.

Schemas

item is what you send, config how the tool behaves, and the response is what you get back.

Item

object
Properties
query string required

The entity or topic to search for in the Knowledge Graph

min length 1

Example
{
  "query": "string"
}

Configuration

object
Properties
limit integer

Maximum number of entities to return (1-50)

Default: 10

min 1, max 50

types array

Filter results by entity types (e.g., Person, Place, Organization)

languages array

Filter results by language codes (e.g., en, fr, es)

Example
{
  "limit": 10,
  "types": [
    "string"
  ],
  "languages": [
    "string"
  ]
}

Response

object
Properties
query string required

The search query that was executed

entities array required

List of found entities with their information

Items: Entity

total_count integer required

Total number of entities found

Example
{
  "query": "string",
  "entities": [
    {
      "name": "string",
      "description": "",
      "types": [
        "string"
      ],
      "result_score": 0.0,
      "url": "",
      "image": "",
      "detailed_description": "",
      "detailed_description_url": ""
    }
  ],
  "total_count": 0
}

Type Definitions

1 type

These are the available sub-object types that can be used in the properties above.

Entity object
#
name string required
description string

Default: ""

types array
result_score number

Default: 0.0

url string

Default: ""

image string

Default: ""

detailed_description string

Default: ""

detailed_description_url string

Default: ""

Endpoints

POST http://agents.botify.com/{organization}/{project}/google_knowledge_graph/process
POST http://agents.botify.com/{organization}/{project}/google_knowledge_graph/batch_process
POST http://agents.botify.com/{organization}/{project}/google_knowledge_graph/async_process
POST http://agents.botify.com/{organization}/{project}/google_knowledge_graph/async_batch_process

See running a long job in the background for the polling flow.

cURL

curl -X POST "http://agents.botify.com/{organization}/{project}/google_knowledge_graph/process" \
  -H "Authorization: Bearer $BOTIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "item": {
    "query": "<query>"
  }
}'

Over MCP

This tool is exposed as the MCP tool google_knowledge_graph. An MCP client passes organization, project and item as tool arguments. Set up MCP →

Raw metadata