GDELT MCP integration
Search global news coverage and timeline signals from the GDELT DOC 2.0 API.
Sign in and add GDELT in Apps. No GDELT account is required.
Tools
| Name | Description |
|---|---|
search_articlesSearch GDELT DOC 2.0 article results for global news coverage. | Search GDELT DOC 2.0 article results for global news coverage. |
article_timelineReturn a raw GDELT DOC 2.0 volume timeline for a query. | Return a raw GDELT DOC 2.0 volume timeline for a query. |
search_imagesSearch GDELT DOC 2.0 image-collage results for a query. | Search GDELT DOC 2.0 image-collage results for a query. |
Triggers
| Name | Description |
|---|---|
new_articlesPoll GDELT for newly seen article URLs after the initial baseline. | Poll GDELT for newly seen article URLs after the initial baseline. |
Quick Start
import { WeavzClient } from '@weavz-io/sdk'
const weavz = new WeavzClient({ apiKey: 'wvz_...' })
const result = await weavz.actions.execute('gdelt', 'search_articles', {
workspaceId: '550e8400-e29b-41d4-a716-446655440000',
integrationAlias: 'gdelt',
input: { /* ... */ },
})Related Integrations
Works well with
Frequently Asked Questions
Is there a GDELT MCP server through Weavz?
Yes. Add the GDELT integration to a Weavz workspace, enable the actions you need and connect any required account. Weavz provides the workspace MCP endpoint in Tool Mode or Code Mode. The catalog currently lists 3 GDELT actions.
What can an AI agent do with GDELT?
Available actions include Search Articles, Article Timeline, Search Images. Your workspace exposes only the actions you enable. The agent also needs the intended account access and any required input values.
How do I connect GDELT to Claude or ChatGPT?
Use a compatible remote MCP client, add the Weavz connector and choose a workspace. Add GDELT, connect the required account and review the enabled actions. Client availability and account requirements vary; adding the connector does not authorize every app automatically.
Can I use GDELT through an API or SDK?
Yes, supported actions can run through the Weavz REST API, TypeScript SDK or Python SDK. Configure a workspace and the required connections, use scoped access, and pass the intended end-user context when acting for a customer.
What authentication does GDELT require?
This catalog integration does not require a stored external account connection. Provider terms, rate limits and tool-specific inputs can still apply.
How do I review sensitive GDELT actions?
Limit enabled actions, scope credentials to the intended user and configure Human Gates for the operations that need review. A matching policy can pause a send, record change or other sensitive action for an approver before execution.
What limits or costs apply to GDELT?
Weavz plan limits apply to the actions and resources you use. The external provider may also require an account, a paid plan, API credits or specific permissions, and may enforce its own rate limits. Check current Weavz pricing and the provider’s terms before rollout.
What GDELT triggers are available?
The catalog lists 1 triggers, including New Articles. Configure the trigger and your event handler before using incoming events to start work.
Connect GDELT in minutes
Get 20,000 free action executions every month. No credit card required.