Felt | Composio Docs

Overview

SLUG: FELT

Description

Felt is a modern GIS platform that allows users to create, modify, and share interactive maps, integrating powerful mapping capabilities into various workflows and applications.

Authentication Details

API Key

bearer_token

stringRequired

Connecting to Felt

Create an auth config

Use the dashboard to create an auth config for the Felt toolkit. This allows you to connect multiple Felt accounts to Composio for agents to use.

Select App

Navigate to the Felt toolkit page and click “Setup Integration”.

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

Create and Get auth config ID

Click “Create Integration”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1 from composio import Composio
2 
3 # Replace these with your actual values
4 felt_auth_config_id = "ac_YOUR_FELT_CONFIG_ID" # Auth config ID created above
5 user_id = "0000-0000-0000"  # UUID from database/app
6 
7 composio = Composio()
8 
9 def authenticate_toolkit(user_id: str, auth_config_id: str):
10     # Replace this with a method to retrieve an API key from the user.
11     # Or supply your own.
12     user_api_key = input("[!] Enter API key")
13 
14     connection_request = composio.connected_accounts.initiate(
15         user_id=user_id,
16         auth_config_id=auth_config_id,
17         config={"auth_scheme": "API_KEY", "val": user_api_key}
18     )
19 
20     # API Key authentication is immediate - no redirect needed
21     print(f"Successfully connected Felt for user {user_id}")
22     print(f"Connection status: {connection_request.status}")
23     
24     return connection_request.id
25 
26 
27 connection_id = authenticate_toolkit(user_id, felt_auth_config_id)
28 
29 # You can verify the connection using:
30 connected_account = composio.connected_accounts.get(connection_id)
31 print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Felt toolkit’s playground

OpenAI (Python)

Anthropic (TypeScript)

Google (Python)

Vercel (TypeScript)

Python

1 from composio import Composio
2 from openai import OpenAI
3 import json
4 
5 openai = OpenAI()
6 composio = Composio()
7 
8 # User ID must be a valid UUID format
9 user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10 
11 tools = composio.tools.get(user_id=user_id, toolkits=["FELT"])
12 
13 print("[!] Tools:")
14 print(json.dumps(tools))
15 
16 def invoke_llm(task = "What can you do?"):
17     completion = openai.chat.completions.create(
18         model="gpt-4o",
19         messages=[
20             {
21                 "role": "user",
22                 "content": task,  # Your task here!
23             },
24         ],
25         tools=tools,
26     )
27 
28     # Handle Result from tool call
29     result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30     print(f"[!] Completion: {completion}")
31     print(f"[!] Tool call result: {result}")
32 
33 invoke_llm()

Tool List

FELT_CREATE_OR_UPDATE_ELEMENTS

Tool Name: Create or Update Elements

Description

Tool to create new elements or update existing elements on a map via geojson featurecollection. use when you need to batch add or modify elements on a specified map after confirming the map id.

Action Parameters

features

arrayRequired

map_id

stringRequired

type

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

FELT_CREATE_PROJECT

Tool Name: Create Project

Description

Tool to create a new felt project. use when you need to initialize a project with a specific name, and optional description or organization context.

Action Parameters

description

string

name

stringRequired

organization_id

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

FELT_DELETE_ELEMENT

Tool Name: Delete Element

Description

Tool to delete a specific element from a map. use when you have both map and element ids and need to remove the element permanently.

Action Parameters

element_id

stringRequired

map_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

FELT_DELETE_LAYER

Tool Name: Delete Layer

Description

Tool to delete a specific layer from a map. use when you have the map's and layer's ids and need to remove it permanently.

Action Parameters

layer_id

stringRequired

map_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

FELT_DELETE_MAP

Tool Name: Delete Map

Description

Tool to delete a specific map. use when you have the map's id and want to permanently remove it. returns no content (http 204) on success.

Action Parameters

map_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

FELT_DELETE_PROJECT

Tool Name: Delete Project

Description

Tool to delete a project and all its contents. use when you need to permanently remove a project after confirmation.

Action Parameters

project_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

FELT_DUPLICATE_MAP

Tool Name: Duplicate Map

Description

Tool to duplicate an existing map in felt. use when you need a clone of a map as a starting point.

Action Parameters

description

string

map_id

stringRequired

organization_id

string

title

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

FELT_FELT_CREATE_PROJECT

Tool Name: Create Felt Project

Description

Tool to create a new felt project. use when you need to initialize a project with a specific name and optional description or organization context.

Action Parameters

description

string

name

stringRequired

organization_id

string

visibility

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

FELT_GET_MAP_DETAILS

Tool Name: Get Map Details

Description

Tool to retrieve details of a specific map. use when you have a valid map id and need full map metadata.

Action Parameters

map_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

FELT_GET_USER_DETAILS

Tool Name: Get User Details

Description

Tool to retrieve information about the authenticated user. use after obtaining a valid token to fetch user profile details.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

FELT_LIST_ELEMENTS

Tool Name: List Elements

Description

Tool to list all elements on a specific map as geojson features. use after confirming a valid map id when you need to retrieve the map's elements.

Action Parameters

map_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

FELT_LIST_ELEMENT_GROUPS

Tool Name: List Element Groups

Description

Tool to list all element groups on a specific map. use after confirming a valid map id when you need to enumerate grouped elements.

Action Parameters

map_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

FELT_LIST_LAYERS

Tool Name: List Layers

Description

Tool to list all layers on a specific map. use after confirming the map id.

Action Parameters

limit

integer

map_id

stringRequired

starting_after

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

FELT_LIST_PROJECTS

Tool Name: List Projects

Description

Tool to retrieve a list of projects accessible to the user. use when you need to browse or select from existing projects before proceeding.

Action Parameters

organization_id

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

FELT_LIST_SOURCES

Tool Name: List Sources

Description

Tool to retrieve a list of data sources accessible to the user. use when you need to enumerate all available sources before selecting one.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

FELT_UPDATE_PROJECT

Tool Name: Update Project

Description

Tool to update an existing project's name, description, or custom properties. use after confirming the project id.

Action Parameters

customProperties

object

description

string

name

string

project_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired